{"_id":"3gpp-mcp-server","name":"3gpp-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"3gpp-mcp-server","version":"1.0.0","description":"MCP Server for querying 3GPP telecom protocol specifications","main":"dist/index.js","type":"commonjs","directories":{"doc":"docs","test":"tests"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"jest","lint":"eslint src/**/*.ts","clean":"rm -rf dist"},"keywords":["mcp","3gpp","telecom","llm","ai","protocols"],"author":"","license":"MIT","engines":{"node":">=18.0.0"},"devDependencies":{"@types/fs-extra":"^11.0.4"},"types":"./dist/index.d.ts","_id":"3gpp-mcp-server@1.0.0","_nodeVersion":"18.19.1","_npmVersion":"9.2.0","dist":{"integrity":"sha512-h8pGLKVepYoR5z+uphxYJZd+UbiIy4HeceX+gkKNrXJEp14D7LMnj30i6Qd2iui8tuzFEBM2bwoNSgWhZMOaAw==","shasum":"74776e16d62efa514eee6f5c85ef6b8457445e82","tarball":"https://registry.npmjs.org/3gpp-mcp-server/-/3gpp-mcp-server-1.0.0.tgz","fileCount":130,"unpackedSize":872753,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCuYeeWKcagFRLdfo9fkxFtx2pQngkFztF+1F+EE3dONAIhAL7kr7IuOuQGQlGNG58cP4hQpZ8NVpZam+RLWtmnZAt3"}]},"_npmUser":{"name":"narendralomada","email":"narendravithal@gmail.com"},"maintainers":[{"name":"narendralomada","email":"narendravithal@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/3gpp-mcp-server_1.0.0_1758117978293_0.8875521240659185"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-17T14:06:18.292Z","1.0.0":"2025-09-17T14:06:18.562Z","modified":"2025-09-17T14:06:18.924Z"},"maintainers":[{"name":"narendralomada","email":"narendravithal@gmail.com"}],"description":"MCP Server for querying 3GPP telecom protocol specifications","keywords":["mcp","3gpp","telecom","llm","ai","protocols"],"license":"MIT","readme":"# 3GPP MCP Server\n\nAn MCP (Model Context Protocol) server that provides LLMs with access to 3GPP telecom protocol specifications and enables intelligent querying of technical documentation.\n\n## Features\n\n- **Semantic Search**: Search through 3GPP specification documents using natural language queries\n- **Specification Details**: Get detailed information about specific 3GPP specifications\n- **Protocol Information**: Query information about 3GPP protocols and procedures\n- **Related Documents**: Find specifications related to specific topics\n- **Resources**: Access to specification catalogs, protocol lists, and release timelines\n- **Prompts**: Pre-written templates for common 3GPP-related queries\n\n## Installation\n\n1. Clone this repository\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Build the project:\n   ```bash\n   npm run build\n   ```\n\n4. (Optional) Download TSpec-LLM dataset:\n   ```bash\n   node dist/download-dataset.js\n   ```\n\n## Usage\n\n### With Claude Desktop\n\n1. Add the server configuration to your Claude Desktop config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"3gpp-server\": {\n      \"command\": \"node\",\n      \"args\": [\"dist/index.js\"],\n      \"cwd\": \"/path/to/3gpp-mcp-server\"\n    }\n  }\n}\n```\n\n2. Restart Claude Desktop\n3. The server will be available with the following tools:\n\n### Available Tools\n\n#### `search_3gpp_specs`\nSearch through 3GPP specification documents using semantic search.\n\n**Parameters:**\n- `query` (string, required): Search query text\n- `series` (array, optional): Filter by specification series (e.g., [\"24\", \"25\"])\n- `releases` (array, optional): Filter by 3GPP releases (e.g., [\"Rel-15\", \"Rel-16\"])\n- `limit` (number, optional): Maximum number of results (1-50, default: 10)\n- `offset` (number, optional): Offset for pagination (default: 0)\n\n#### `get_specification_details`\nGet detailed information about a specific 3GPP specification.\n\n**Parameters:**\n- `specId` (string, required): Specification ID (e.g., \"TS 24.301\")\n- `format` (string, optional): Level of detail - \"summary\", \"detailed\", or \"raw\" (default: \"summary\")\n\n#### `query_protocol_info`\nGet information about specific 3GPP protocols and procedures.\n\n**Parameters:**\n- `protocolName` (string, required): Name of the protocol (e.g., \"NAS\", \"RRC\")\n- `queryType` (string, optional): Type of information - \"procedures\", \"messages\", or \"overview\" (default: \"overview\")\n\n#### `find_related_specs`\nFind specifications related to a given topic or specification.\n\n**Parameters:**\n- `topic` (string, required): Topic or specification to find related documents for\n- `maxResults` (number, optional): Maximum number of related specs to return (default: 5)\n\n### Available Resources\n\n- `3gpp://specifications/catalog`: Complete catalog of available 3GPP specifications\n- `3gpp://protocols/list`: List of all 3GPP protocols with descriptions\n- `3gpp://releases/timeline`: Timeline of 3GPP releases and their major features\n\n### Available Prompts\n\n- `explain_3gpp_procedure`: Explain a specific 3GPP procedure in detail\n- `compare_specifications`: Compare two 3GPP specifications highlighting differences\n\n## Example Usage\n\nOnce integrated with Claude Desktop, you can use natural language queries like:\n\n- \"Search for NAS authentication procedures in LTE specifications\"\n- \"Show me details about TS 24.301\"\n- \"What are the key procedures in RRC protocol?\"\n- \"Find specifications related to 5G security\"\n- \"Explain the attach procedure in detail\"\n- \"Compare TS 36.331 and TS 38.331\"\n\n## Architecture\n\nThe server consists of several key components:\n\n- **Specification Manager**: Handles loading and managing 3GPP specifications\n- **Search Engine**: Provides semantic search capabilities across documents\n- **Document Processor**: Extracts and processes content from specification documents\n- **MCP Server**: Implements the Model Context Protocol interface\n\n## Data Source\n\nThis server is designed to work with the TSpec-LLM dataset, which contains processed 3GPP documentation from Release 8 to Release 19. The dataset is available at: https://huggingface.co/datasets/rasoul-nikbakht/TSpec-LLM\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts              # Main MCP server implementation\n├── types/\n│   └── 3gpp.ts          # TypeScript type definitions\n└── utils/\n    ├── specification-manager.ts  # Specification management\n    ├── search-engine.ts         # Search functionality\n    ├── document-processor.ts    # Document processing\n    └── dataset-downloader.ts    # Dataset download utilities\n```\n\n### Scripts\n\n- `npm run build`: Build the TypeScript project\n- `npm run dev`: Build and watch for changes\n- `npm start`: Run the compiled server\n- `npm test`: Run tests (when implemented)\n\n## Future Enhancements\n\n- Vector embeddings for improved semantic search\n- Integration with ChromaDB or similar vector databases\n- Support for real-time specification updates\n- Enhanced natural language processing for complex queries\n- PDF support for additional specification formats\n- Caching layer for improved performance\n\n## Contributing\n\nContributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.\n\n## License\n\nMIT License\n\n## Acknowledgments\n\n- Built using the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/sdk)\n- Designed to work with the [TSpec-LLM dataset](https://huggingface.co/datasets/rasoul-nikbakht/TSpec-LLM)\n- Supports 3GPP specifications from [3GPP.org](https://www.3gpp.org/)","readmeFilename":"README.md","_rev":"1-3d5c48d4ffeb6c892951e34c8879187d"}