mcp-server-3gpp

MCP-Server für 3GPP- und IETF-RFC-Spezifikationen, basierend auf einem vorgefertigten SQLite-Korpus.

Der aktuelle v2-Server basiert auf KI-gestützter Kapitelnavigation, nicht auf fest codierter Protokoll-Suchlogik. Der beabsichtigte Arbeitsablauf ist:

1. Relevante Spezifikationen mit get_spec_catalog oder search_3gpp_docs entdecken.

2. Die Kapitelstruktur mit get_spec_toc durchlaufen.

3. Den genauen Text mit get_section abrufen.

4. Lokal mit search_related_sections erweitern.

5. Mit get_spec_references zwischen Dokumenten springen.

Die Suche ist ein Ausgangspunkt, nicht das gesamte Produkt. Es wird erwartet, dass das Modell die Kapitel gezielt durchsucht und auswählt.

Was heute ausgeliefert wird

• DB-basierter v2-Server mit 8 MCP-Tools

• Vorgefertigter Korpus in data/corpus/3gpp.db

• Insgesamt 207 Spezifikationen: 112 TS, 2 TR, 93 RFC

• 66.109 vollständige Abschnitte und 63.376 Inhaltsverzeichnis-Zeilen

• 45.162 Referenzverknüpfungen zwischen Spezifikationen

• Stdio MCP-Einstiegspunkt in src/index.js

• Optionaler Streamable HTTP-Transport in src/http.js

Related MCP server: 3GPP MCP Server

Suchverhalten

• search_3gpp_docs bietet eine Stichwortsuche mit Phrasen in Anführungszeichen, spec:-Filtern, section:-Hinweisen und Negation.

• Die Datenbank und Laufzeitumgebung können sqlite-vec-Einbettungen über vec_sections hosten.

• Der Standard-MCP-Toolpfad ist weiterhin stichwortbasiert, sofern der Suchschicht keine Abfrage-Einbettungsfunktion bereitgestellt wird. Gehen Sie also nicht davon aus, dass semantisches Ranking aktiv ist, nur weil vec_sections existiert.

Schnellstart

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

Die mitgelieferte Datenbank wird mit Git LFS nachverfolgt. Ein erfolgreicher Start sieht so aus:

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

MCP-Client-Konfiguration

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"]
 }
 }
}

Optionaler benutzerdefinierter DB-Pfad

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

Der Server prüft diese DB-Speicherorte in der folgenden Reihenfolge:

1. THREEGPP_DB_PATH

2. data/corpus/3gpp.db

3. data/3gpp.db

Tool-Oberfläche

Empfohlenes Prompting-Muster

Verwenden Sie Prompts, die eine strukturorientierte Navigation fördern:

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.

Korpus-Statistiken

Architektur auf einen Blick

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

Weitere Details finden Sie in docs/architecture.md und docs/data-model.md.

Validierung und Tests

npm run validate
npm test

npm run validate überprüft die Paketmetadaten, löst den DB-Pfad auf, verifiziert das Kernschema und die Anzahl der Einträge und bestätigt, dass der v2-Server die aktuelle 8-Tool-Oberfläche registriert.

Projektstruktur

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

Hinweise

• Das dokumentierte Betriebsmodell ist der DB-basierte v2-Server.

• Es gibt weiterhin einen Legacy-Fallback-Pfad in src/index.js, falls keine SQLite-DB gefunden wird, aber dies ist ein Bootstrap-Notausgang, nicht die primäre Schnittstelle, die dieses Repository dokumentiert.

• get_section und get_spec_toc sind die deterministischen Kern-Abrufwerkzeuge. Die Suche sollte diese füttern, nicht ersetzen.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• get_emm_causeB
• list_specsB
• search_3gpp_docsB