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개의 목차(TOC) 행

• 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