mcp-server-3gpp

Servidor MCP para especificaciones 3GPP e IETF RFC, respaldado por un corpus SQLite preconstruido.

El servidor v2 actual está diseñado en torno a la navegación por capítulos guiada por IA, no en una lógica de búsqueda de protocolos codificada de forma rígida. El flujo de trabajo previsto es:

1. Descubrir especificaciones relevantes con get_spec_catalog o search_3gpp_docs.

2. Recorrer la estructura de capítulos con get_spec_toc.

3. Recuperar el texto exacto con get_section.

4. Expandir localmente con search_related_sections.

5. Saltar entre documentos con get_spec_references.

La búsqueda es un punto de partida, no el producto completo. Se espera que el modelo explore y elija los capítulos de forma deliberada.

Lo que se incluye hoy

• Servidor v2 respaldado por base de datos con 8 herramientas MCP

• Corpus preconstruido en data/corpus/3gpp.db

• 207 especificaciones en total: 112 TS, 2 TR, 93 RFC

• 66,109 secciones completas y 63,376 filas de tabla de contenido (TOC)

• 45,162 enlaces de referencia entre especificaciones

• Punto de entrada MCP Stdio en src/index.js

• Transporte HTTP Streamable opcional en src/http.js

Related MCP server: 3GPP MCP Server

Comportamiento de búsqueda

• search_3gpp_docs expone la búsqueda por palabras clave con frases entre comillas, filtros spec:, sugerencias section: y negación.

• La base de datos y el tiempo de ejecución pueden alojar incrustaciones (embeddings) de sqlite-vec a través de vec_sections.

• La ruta de la herramienta MCP predeterminada sigue siendo basada en palabras clave a menos que se proporcione una función de incrustación de consulta a la capa de búsqueda, por lo que no asuma que la clasificación semántica está activa solo porque vec_sections existe.

Inicio rápido

git lfs install
git clone https://github.com/Lee-SiHyeon/mcp-server-3gpp.git
cd mcp-server-3gpp
npm install
npm run validate
npm start

La base de datos incluida se rastrea con Git LFS. Un inicio correcto se ve así:

[3GPP MCP] Database ready: .../data/corpus/3gpp.db
[3GPP MCP] Features - FTS: true, Vector: true
[3GPP MCP] Registered 8 tools (v2 DB mode)

Configuración del cliente MCP

Claude Desktop

{
 "mcpServers": {
 "3gpp": {
 "command": "node",
 "args": ["/absolute/path/to/mcp-server-3gpp/src/index.js"]
 }
 }
}

VS Code / GitHub Copilot

{
 "servers": {
 "3gpp": {
 "type": "stdio",
 "command": "node",
 "args": ["/absolute/path/to/mcp-server-3gpp/src/index.js"]
 }
 }
}

Ruta de base de datos personalizada opcional

{
 "env": {
 "THREEGPP_DB_PATH": "/custom/path/to/3gpp.db"
 }
}

El servidor verifica estas ubicaciones de base de datos en orden:

1. THREEGPP_DB_PATH

2. data/corpus/3gpp.db

3. data/3gpp.db

Superficie de herramientas

Patrón de prompts recomendado

Utilice prompts que fomenten la navegación basada primero en la estructura:

Find the chapter in TS 24.301 that defines attach reject causes.
Start by locating the spec, then inspect the TOC, then fetch the most relevant section.

I need the exact wording for the NAS registration timer behavior in 5G.
Search for likely sections, then read the chapter text and nearby sections.

Show which RFCs and 3GPP specs TS 29.500 cites most often.

Estadísticas del corpus

Arquitectura de un vistazo

LLM client
 -> MCP transport (stdio or HTTP)
 -> tool registry + validation
 -> tool handlers
 -> SQLite corpus (specs, toc, sections, sections_fts, spec_references, ingestion_runs)
 -> optional vec_sections table and guide resources

Más detalles se encuentran en docs/architecture.md y docs/data-model.md.

Validación y pruebas

npm run validate
npm test

npm run validate verifica los metadatos del paquete, resuelve la ruta de la base de datos, verifica el esquema central y los recuentos, y confirma que el servidor v2 registra la superficie actual de 8 herramientas.

Estructura del proyecto

mcp-server-3gpp/
├── src/
│ ├── index.js
│ ├── http.js
│ ├── db/
│ ├── search/
│ ├── tools/
│ └── ingest/
├── docs/
├── db/
├── data/
│ └── corpus/
│ └── 3gpp.db
├── test/
├── validate.js
└── package.json

Notas

• El modelo operativo documentado es el servidor v2 respaldado por base de datos.

• Todavía existe una ruta de respaldo heredada en src/index.js si no se encuentra ninguna base de datos SQLite, pero eso es una vía de escape de arranque, no la interfaz principal que documenta este repositorio.

• get_section y get_spec_toc son las herramientas de recuperación deterministas principales. La búsqueda debe alimentarlas, no reemplazarlas.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• get_emm_causeB
• list_specsB
• search_3gpp_docsB