mcp-server-3gpp

構築済みのSQLiteコーパスをバックエンドとする、3GPPおよびIETF RFC仕様書用のMCPサーバーです。

現在のv2サーバーは、ハードコードされたプロトコル検索ロジックではなく、AI主導の章ナビゲーションを中心に構築されています。想定されるワークフローは以下の通りです：

1. get_spec_catalog または search_3gpp_docs を使用して関連する仕様書を発見する。

2. get_spec_toc を使用して章構成を辿る。

3. get_section を使用して正確なテキストを取得する。

4. search_related_sections を使用してローカルで情報を拡張する。

5. get_spec_references を使用してドキュメント間を移動する。

検索は出発点であり、製品のすべてではありません。モデルは意図的に章を選択して閲覧することが期待されています。

現在提供されているもの

• 8つのMCPツールを備えたDBバックエンドのv2サーバー

• data/corpus/3gpp.db にある構築済みコーパス

• 合計207の仕様書：112 TS、2 TR、93 RFC

• 66,109の全セクションおよび63,376の目次行

• 45,162の仕様書間参照エッジ

• src/index.js にあるStdio MCPエントリーポイント

• src/http.js にあるオプションのStreamable HTTPトランスポート

Related MCP server: 3GPP MCP Server

検索の動作

• search_3gpp_docs は、引用符付きフレーズ、spec: フィルター、section: ヒント、および否定演算子を使用したキーワード検索を提供します。

• データベースとランタイムは vec_sections を介して sqlite-vec 埋め込みをホストできます。

• デフォルトのMCPツールパスは、検索レイヤーにクエリ埋め込み関数が提供されない限りキーワード優先のままです。そのため、vec_sections が存在するからといってセマンティックランキングが有効であると想定しないでください。

クイックスタート

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

バンドルされたデータベースはGit LFSで管理されています。正常な起動状態は以下のようになります：

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

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

オプションのカスタムDBパス

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

サーバーは以下の順序でDBの場所を確認します：

1. THREEGPP_DB_PATH

2. data/corpus/3gpp.db

3. data/3gpp.db

ツールインターフェース

推奨されるプロンプトパターン

構造を優先したナビゲーションを促すプロンプトを使用してください：

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.

コーパス統計

アーキテクチャの概要

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

詳細は docs/architecture.md および docs/data-model.md を参照してください。

検証とテスト

npm run validate
npm test

npm run validate は、パッケージのメタデータをチェックし、DBパスを解決し、コアスキーマとカウントを検証し、v2サーバーが現在の8つのツールインターフェースを登録していることを確認します。

プロジェクト構造

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

注意事項

• 文書化されている運用モデルは、DBバックエンドのv2サーバーです。

• SQLite DBが見つからない場合のレガシーなフォールバックパスが src/index.js に残っていますが、これはブートストラップ用の緊急手段であり、このリポジトリで文書化されている主要なインターフェースではありません。

• get_section と get_spec_toc が決定論的な取得を行うコアツールです。検索はこれらを補完するものであり、置き換えるものではありません。

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• get_emm_causeB
• list_specsB
• search_3gpp_docsB