{"id":24538787,"url":"https://github.com/spences10/mcp-svelte-docs","last_synced_at":"2025-03-16T02:25:31.281Z","repository":{"id":273336307,"uuid":"919381431","full_name":"spences10/mcp-svelte-docs","owner":"spences10","description":"🔍 MCP server that lets you search and access Svelte documentation with built-in caching","archived":false,"fork":false,"pushed_at":"2025-03-08T10:24:18.000Z","size":492,"stargazers_count":7,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-08T11:24:45.510Z","etag":null,"topics":["developer-tools","documentation","libsql","llm","mcp","model-context-protocol","search","svelte"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spences10.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-20T09:39:02.000Z","updated_at":"2025-02-26T13:43:19.000Z","dependencies_parsed_at":"2025-02-28T15:28:08.512Z","dependency_job_id":"8f9ea35e-1119-4f29-b6a8-921fb8b7e875","html_url":"https://github.com/spences10/mcp-svelte-docs","commit_stats":null,"previous_names":["spences10/mcp-svelte-docs"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-svelte-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-svelte-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-svelte-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spences10%2Fmcp-svelte-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spences10","download_url":"https://codeload.github.com/spences10/mcp-svelte-docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243814980,"owners_count":20352077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["developer-tools","documentation","libsql","llm","mcp","model-context-protocol","search","svelte"],"created_at":"2025-01-22T15:15:33.124Z","updated_at":"2025-03-16T02:25:31.257Z","avatar_url":"https://github.com/spences10.png","language":"TypeScript","funding_links":[],"categories":["📚 Documentation","Developer Tools","Education and Learning","📚 Projects (2474 total)","Developer Tools Mcp Servers"],"sub_categories":["How to Submit","MCP Servers"],"readme":"# mcp-svelte-docs\n\nA Model Context Protocol (MCP) server that provides efficient access\nto Svelte documentation with advanced caching, search capabilities,\nand optimised content delivery. This server integrates directly with\nSvelte's official documentation, offering both full and compressed\nvariants suitable for different LLM context window sizes.\n\n\u003ca href=\"https://glama.ai/mcp/servers/wu4hy1xtjb\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/wu4hy1xtjb/badge\" /\u003e\n\u003c/a\u003e\n\n## Features\n\n- 📚 Complete Svelte documentation access through MCP Resources\n- 🔍 Advanced search capabilities:\n  - Document type filtering (API, Tutorial, Example, Error)\n  - Section hierarchy awareness\n  - Intelligent relevance scoring based on:\n    - Term frequency\n    - Section importance\n    - Document type relevance\n    - Exact phrase matching\n  - Context-aware result excerpts\n  - Related search suggestions\n- 💾 Efficient caching with LibSQL\n- 🔄 Automatic content freshness checks\n- 📦 Support for package-specific documentation (Svelte, Kit, CLI)\n- 📏 Smart content chunking for large documents\n- 🗜️ Compressed variants for smaller context windows\n- 🏗️ Built on the Model Context Protocol\n\n## Configuration\n\nThis server requires configuration through your MCP client. Here are\nexamples for different environments:\n\n### Cline Configuration\n\nAdd this to your Cline MCP settings:\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"svelte-docs\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"mcp-svelte-docs\"],\n\t\t\t\"env\": {\n\t\t\t\t\"LIBSQL_URL\": \"file:local.db\",\n\t\t\t\t\"LIBSQL_AUTH_TOKEN\": \"your-auth-token-if-using-remote-db\"\n\t\t\t}\n\t\t}\n\t}\n}\n```\n\n### Claude Desktop with WSL Configuration\n\nFor WSL environments, add this to your Claude Desktop configuration:\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"svelte-docs\": {\n\t\t\t\"command\": \"wsl.exe\",\n\t\t\t\"args\": [\n\t\t\t\t\"bash\",\n\t\t\t\t\"-c\",\n\t\t\t\t\"LIBSQL_URL=file:local.db LIBSQL_AUTH_TOKEN=your-token npx -y mcp-svelte-docs\"\n\t\t\t]\n\t\t}\n\t}\n}\n```\n\n### Environment Variables\n\nThe server supports the following environment variables:\n\n- `LIBSQL_URL` (optional): URL for the LibSQL database. Defaults to\n  `file:local.db`\n- `LIBSQL_AUTH_TOKEN` (optional): Auth token for remote LibSQL\n  database\n\n## API\n\nThe server implements both MCP Resources and Tools:\n\n### Resources\n\nAccess documentation through these URIs:\n\n- `svelte-docs://docs/llms.txt` - Documentation index\n- `svelte-docs://docs/llms-full.txt` - Complete documentation\n- `svelte-docs://docs/llms-small.txt` - Compressed documentation\n- `svelte-docs://docs/{package}/llms.txt` - Package-specific\n  documentation\n  - Supported packages: svelte, kit, cli\n\n### Tools\n\n#### search_docs\n\nEnhanced search functionality with advanced filtering and context\nawareness.\n\nParameters:\n\n- `query` (string, required): Search keywords or natural language\n  query\n- `doc_type` (string, optional): Filter by documentation type\n  - Values: 'api', 'tutorial', 'example', 'error', 'all'\n  - Default: 'all'\n- `context` (number, optional): Number of surrounding paragraphs (0-3)\n  - Default: 1\n- `include_hierarchy` (boolean, optional): Include section hierarchy\n  - Default: true\n\nExample Usage:\n\n```json\n// API Reference Search\n{\n  \"query\": \"bind:value directive\",\n  \"doc_type\": \"api\",\n  \"context\": 1\n}\n\n// Tutorial Search\n{\n  \"query\": \"routing sveltekit\",\n  \"doc_type\": \"tutorial\",\n  \"context\": 2,\n  \"include_hierarchy\": true\n}\n```\n\n#### get_next_chunk\n\nRetrieve subsequent chunks of large documents.\n\nParameters:\n\n- `uri` (string, required): Document URI\n- `chunk_number` (number, required): Chunk number to retrieve\n  (1-based)\n\n## Development\n\n### Setup\n\n1. Clone the repository\n2. Install dependencies:\n\n```bash\npnpm install\n```\n\n3. Build the project:\n\n```bash\npnpm build\n```\n\n4. Run in development mode:\n\n```bash\npnpm dev\n```\n\n### Publishing\n\n1. Update version in package.json\n2. Build the project:\n\n```bash\npnpm build\n```\n\n3. Publish to npm:\n\n```bash\npnpm publish\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Built on the\n  [Model Context Protocol](https://github.com/modelcontextprotocol)\n- Powered by [Svelte Documentation](https://svelte.dev)\n- Uses [LibSQL](https://github.com/libsql/libsql) for efficient\n  caching\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspences10%2Fmcp-svelte-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspences10%2Fmcp-svelte-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspences10%2Fmcp-svelte-docs/lists"}