3gpp MCP Server

🚀 3GPP MCP Server V3.0.0 - 直接仕様アクセス

TSpec-LLMの5億3500万語のデータセットに直接アクセスすることで、あなたのAIアシスタントを3GPP仕様の専門家に変えましょう！

🚀 クイックスタート

このサーバーの機能

従来：AIに3GPP仕様について尋ねる - 学習データに基づいた一般的な応答を得る 導入後：AI + 3GPP MCP Server V3.0.0を使用する - 構造化された、エージェント向けの応答で、現在の仕様内容に直接アクセスする

革新的なV3.0.0アーキテクチャ

V3.0.0は真のMCPアプローチを表しています。軽量なAPIブリッジを介して、直接仕様データを提供します。

エージェントクエリ → MCPツール → 外部API → 実際の仕様データ

主な利点

• 真のMCPアーキテクチャ - 軽量なAPIブリッジ（約10MB vs 15GB以上）
• 500ms未満の応答時間 - 外部APIとの統合によるインテリジェントキャッシュ
• エージェント最適化 - AIエージェントが消費するための構造化されたJSON応答
• 実際の仕様データ - TSpec-LLMの5億3500万語のデータセットに直接アクセス
• 外部API統合 - Hugging Face + 3GPP.orgのAPI
• 無限のスケーラビリティ - ステートレスなAPI呼び出し、ローカルストレージの制限なし

クイックセットアップ（30秒で完了！）

直接MCPセットアップ（推奨）

Claude Desktopユーザー用：

claude mcp add 3gpp-server npx 3gpp-mcp-charging@latest serve

その他のMCPクライアント用： MCP設定に以下を追加します。

{
  "mcpServers": {
    "3gpp-server": {
      "command": "npx",
      "args": ["3gpp-mcp-charging@latest", "serve"],
      "description": "3GPP MCP Server - TSpec-LLMと3GPP仕様への直接アクセス",
      "env": {
        "HUGGINGFACE_TOKEN": "高度なアクセスにはオプション"
      }
    }
  }
}

代替手段：自動構成

# 自動構成付きの1コマンドインストール
npx 3gpp-mcp-charging@latest init

# クライアント固有のインストール
npx 3gpp-mcp-charging@latest init --client claude
npx 3gpp-mcp-charging@latest init --client vscode
npx 3gpp-mcp-charging@latest init --client cursor

動作確認

AIアシスタントに次のように尋ねてみましょう。 "TS 32.290における5G CHF実装要件を検索してください"

実装ガイダンス、依存関係、テストに関する考慮事項を含む構造化された仕様内容が返されるはずです！

✨ 主な機能

利用可能なツール（V3.0.0）

クエリ例

直接仕様検索

"5Gサービスベースアーキテクチャにおける課金手順を探す"
→ 返却結果: TS 32.290の抜粋、CHF実装詳細、Nchfインターフェース仕様

実装要件

"リリース17における統合課金の実装要件を抽出する"
→ 返却結果: 技術要件、依存関係、テストに関する考慮事項、コンプライアンスに関する注意事項

仕様比較

"TS 32.240からTS 32.290までの課金の進化を比較する"
→ 返却結果: 進化のタイムライン、移行分析、実装への影響評価

得られるもの

直接仕様内容

• TSpec-LLMの包括的な3GPPデータセットへのリアルタイムアクセス
• 関連性スコア付きの構造化された内容抜粋
• 公式仕様メタデータの統合

エージェント向け応答

• AIエージェントが消費するために最適化されたJSON形式の応答
• すべてのツール応答にわたる一貫したスキーマ
• すべての応答に埋め込まれた豊富なメタデータ

実装に関する知見

• 仕様からの技術要件抽出
• 依存関係分析と実装ガイダンス
• テストに関する考慮事項とコンプライアンスマッピング

🔧 技術詳細

アーキテクチャ

コアコンポーネント

外部API統合層

• TSpec-LLMクライアント：Hugging Face APIを介してTSpec-LLMデータセットと直接統合
• 3GPP APIクライアント：公式の3GPP.org APIとの統合によるメタデータ取得
• APIマネージャー：すべての外部APIの統一オーケストレーション層

MCPツール層

• search_specifications.ts：直接仕様検索の実装
• get_specification_details.ts：包括的な仕様詳細
• compare_specifications.ts：複数仕様比較
• find_implementation_requirements.ts：要件抽出

キャッシュとパフォーマンス

• NodeCache：インテリジェントなAPI応答キャッシュ
• レート制限：外部APIの適切な使用
• エラーハンドリング：フォールバック機能を備えた堅牢なAPI統合

プロジェクト構造

3gpp-mcp-server-v2/
├── src/                          # V3.0.0のソースコード
│   ├── api/                      # 外部API統合層
│   │   ├── tspec-llm-client.ts   # TSpec-LLM Hugging Faceクライアント
│   │   ├── tgpp-api-client.ts    # 3GPP.org公式APIクライアント
│   │   ├── api-manager.ts        # 統一APIオーケストレーション
│   │   └── index.ts              # APIエクスポート
│   ├── tools/                    # MCPツールの実装
│   │   ├── search-specifications.ts           # 直接仕様検索
│   │   ├── get-specification-details.ts       # 包括的な仕様詳細
│   │   ├── compare-specifications.ts          # 複数仕様比較
│   │   ├── find-implementation-requirements.ts # 要件抽出
│   │   └── index.ts              # ツールエクスポート
│   ├── types/                    # TypeScriptインターフェース
│   └── index.ts                  # MCPサーバーの実装
├── bin/                          # CLIインストールツール
├── docs/                         # ドキュメント
├── tests/                        # テストスイート
└── package.json                  # NPMパッケージ構成

📦 インストール

要件

• Node.js 18以上 - nodejs.orgからダウンロード
• MCP互換のAIアシスタント (Claude Desktop、VS Code、Cursorなど)
• インターネット接続 - 外部APIへのアクセスに必要
• オプション: Hugging Faceトークン - 高度なAPIアクセス用

インストールオプション

オプション1: 直接MCP構成（推奨）

ローカルインストールは必要ありません！サーバーはNPMから直接実行されます。

オプション2: 開発環境セットアップ

# クローンして開発用にセットアップ
git clone <リポジトリURL>
cd 3gpp-mcp-server/3gpp-mcp-server-v2
npm install
npm run build
npm run start

オプション3: 自動構成

npx 3gpp-mcp-charging@latest init

環境変数

# オプション: 高度なAPIアクセス
export HUGGINGFACE_TOKEN="あなたのHugging Faceトークン"

# オプション: カスタムキャッシュ設定
export CACHE_TIMEOUT="3600"  # 秒
export ENABLE_CACHING="true"

バージョンの進化

開発

利用可能なスクリプト

npm run build      # TypeScriptのビルド
npm run dev        # ウォッチ機能付きの開発
npm run start      # サーバーの実行
npm run test       # テストの実行
npm run lint       # コードのリント
npm run clean      # ビルドアーティファクトのクリーンアップ

新しいツールの追加

1. src/tools/にツールクラスを作成する
2. 入力/出力タイプを指定してツールスキーマを定義する
3. API統合を含むexecute()メソッドを実装する
4. ツールをエクスポートし、src/index.tsに登録する

API統合

• 新しいTSpec-LLM機能のためにTSpecLLMClientを拡張する
• 追加の3GPP.orgエンドポイントのためにTGPPApiClientを拡張する
• APIManagerにオーケストレーションメソッドを追加する

🤝 コントリビューション

コントリビューションを歓迎します！以下の点に焦点を当ててください。

• API統合の改善
• パフォーマンスの最適化
• 新しいMCPツールの実装
• ドキュメントの充実

📄 ライセンス

BSD-3条項ライセンス - 詳細についてはLICENSEファイルを参照してください。

謝辞

研究基盤

このプロジェクトのV3.0.0アーキテクチャは、TSpec-LLMの研究に大きく影響を受けています。

TSpec-LLM: A Large Language Model for 3GPP Specifications

• 論文: https://arxiv.org/abs/2406.01768
• 著者: Rasoul Nikbakhtら
• データセット: Hugging Face上のTSpec-LLM

当初はドキュメント参照MCPとして計画されていましたが、TSpec-LLMの研究論文を発見したことで、アプローチが根本的に変わりました。この論文で示された、3GPP仕様への直接LLMアクセスによる大幅な精度向上（25ポイント以上）が、私たちをドキュメントホスティングから、彼らの包括的な5億3500万語のデータセットとの外部API統合に転換させました。

技術基盤

• Model Context Protocol SDKを使用して構築
• TSpec-LLMデータセットと統合
• 3GPP.orgの3GPP仕様をサポート