mcp-server-3gpp

MCP-сервер для спецификаций 3GPP и IETF RFC, работающий на основе предварительно созданного корпуса SQLite.

Текущая версия сервера v2 построена вокруг навигации по главам с помощью ИИ, а не жестко закодированной логики поиска протоколов. Предполагаемый рабочий процесс:

1. Обнаружение соответствующих спецификаций с помощью get_spec_catalog или search_3gpp_docs.

2. Проход по структуре глав с помощью get_spec_toc.

3. Извлечение точного текста с помощью get_section.

4. Локальное расширение с помощью search_related_sections.

5. Переход между документами с помощью get_spec_references.

Поиск — это отправная точка, а не весь продукт. Ожидается, что модель будет целенаправленно просматривать и выбирать главы.

Что доступно сегодня

• Сервер v2 на базе БД с 8 инструментами MCP

• Предварительно созданный корпус в data/corpus/3gpp.db

• Всего 207 спецификаций: 112 TS, 2 TR, 93 RFC

• 66 109 полных разделов и 63 376 строк оглавления (TOC)

• 45 162 перекрестных ссылок между спецификациями

• Точка входа Stdio MCP в src/index.js

• Опциональный транспорт Streamable HTTP в src/http.js

Related MCP server: 3GPP MCP Server

Поведение поиска

• search_3gpp_docs предоставляет ключевой поиск с фразами в кавычках, фильтрами spec:, подсказками section: и отрицанием.

• База данных и среда выполнения могут размещать эмбеддинги sqlite-vec через vec_sections.

• Путь инструмента 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"]
 }
 }
}

Опциональный путь к пользовательской БД

{
 "env": {
 "THREEGPP_DB_PATH": "/custom/path/to/3gpp.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 проверяет метаданные пакета, разрешает путь к БД, проверяет основную схему и количество, а также подтверждает, что сервер 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

Примечания

• Документированная рабочая модель — это сервер v2 на базе БД.

• В src/index.js все еще существует устаревший резервный путь, если база данных SQLite не найдена, но это аварийный выход для загрузки, а не основной интерфейс, который документирует этот репозиторий.

• get_section и get_spec_toc являются основными детерминированными инструментами извлечения. Поиск должен подпитывать их, а не заменять.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• get_emm_causeB
• list_specsB
• search_3gpp_docsB