{"id":40435893,"url":"https://github.com/subspace-lab/simdoc-mcp","last_synced_at":"2026-01-20T16:31:39.887Z","repository":{"id":319932488,"uuid":"1080155414","full_name":"subspace-lab/simdoc-mcp","owner":"subspace-lab","description":"MCP server for scientific simulation documentation (PyBaMM, Cantera, and more)","archived":false,"fork":false,"pushed_at":"2025-10-22T07:05:29.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-22T09:12:57.595Z","etag":null,"topics":["cantera","claude","cursor","mcp","pybamm","scientific-computing","simulation"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/subspace-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-21T00:30:49.000Z","updated_at":"2025-10-22T07:09:30.000Z","dependencies_parsed_at":"2025-10-22T09:13:02.494Z","dependency_job_id":null,"html_url":"https://github.com/subspace-lab/simdoc-mcp","commit_stats":null,"previous_names":["jiweiqi/simdoc-mcp","subspace-lab/simdoc-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/subspace-lab/simdoc-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subspace-lab%2Fsimdoc-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subspace-lab%2Fsimdoc-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subspace-lab%2Fsimdoc-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subspace-lab%2Fsimdoc-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subspace-lab","download_url":"https://codeload.github.com/subspace-lab/simdoc-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subspace-lab%2Fsimdoc-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607206,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cantera","claude","cursor","mcp","pybamm","scientific-computing","simulation"],"created_at":"2026-01-20T16:31:39.789Z","updated_at":"2026-01-20T16:31:39.865Z","avatar_url":"https://github.com/subspace-lab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SimDoc MCP Server\n\nAI-powered code search for scientific simulation documentation. Search PyBaMM, Cantera, and other simulators directly from your AI coding assistant.\n\n## 🚀 Quick Start\n\n### Using the Public Hosted Service (Recommended)\n\nSimDoc provides a **free public MCP server** - no installation required.\n\n**Endpoint:** `https://simdoc.subspace-lab.com/sse`\n\n**Step 1: Add SimDoc to your AI assistant**\n\nChoose your tool:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Desktop\u003c/b\u003e\u003c/summary\u003e\n\n**Config file location:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**Add this configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"simdoc\": {\n      \"url\": \"https://simdoc.subspace-lab.com/sse\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\n**Config file location:**\n- Project: `.mcp.json` (in project root)\n- User: `~/.claude/settings.local.json`\n\n**Add this configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"simdoc\": {\n      \"type\": \"sse\",\n      \"url\": \"https://simdoc.subspace-lab.com/sse\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor\u003c/b\u003e\u003c/summary\u003e\n\n**Config file location:** `~/.cursor/mcp.json`\n\n**Add this configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"simdoc\": {\n      \"url\": \"https://simdoc.subspace-lab.com/sse\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCline (VS Code)\u003c/b\u003e\u003c/summary\u003e\n\n**Setup:** Click \"Configure MCP Servers\" in Cline extension panel\n\n**Add this configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"simdoc\": {\n      \"url\": \"https://simdoc.subspace-lab.com/sse\",\n      \"alwaysAllow\": []\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWindsurf\u003c/b\u003e\u003c/summary\u003e\n\n**Config file location:** Windsurf MCP settings\n\n**Add this configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"simdoc\": {\n      \"url\": \"https://simdoc.subspace-lab.com/sse\"\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n**Step 2: Restart your AI assistant**\n\nCompletely quit and reopen your AI tool.\n\n**Step 3: Try it!**\n\nAsk your AI assistant:\n- *\"How do I simulate battery aging in PyBaMM?\"*\n- *\"Show me Cantera reactor network examples\"*\n- *\"How can I model battery degradation over drive cycles?\"*\n\n---\n\n## 🎯 What You Get\n\n### Available Simulators\n\n| Simulator | Documentation | Examples |\n|-----------|---------------|----------|\n| **PyBaMM** | Battery modeling | 120+ files |\n| **Cantera** | Chemical kinetics \u0026 thermodynamics | 98+ files |\n\n### MCP Tools\n\n- **`resolve-simulator-id`** - Find simulators by name with metadata\n- **`get-simulator-docs`** - Search code snippets and documentation\n\n### Example Queries\n\n1. **Battery Simulations**\n   - \"How do I simulate SEI layer growth in PyBaMM?\"\n   - \"Show me battery calendar aging examples\"\n   - \"How to simulate realistic driving conditions?\"\n\n2. **Reactor Networks**\n   - \"Set up a continuously stirred reactor in Cantera\"\n   - \"Calculate ignition delay times\"\n\n3. **Thermodynamics**\n   - \"How to calculate specific heat of gas mixtures?\"\n   - \"Get entropy and enthalpy properties\"\n\n---\n\n## 🏗️ How It Works\n\n```\n┌──────────────────┐\n│ Your AI Client   │\n│ (Claude/Cursor)  │\n└────────┬─────────┘\n         │\n         │ HTTPS MCP Protocol\n         │\n┌────────▼─────────┐\n│ SimDoc Service   │  https://simdoc.subspace-lab.com/sse\n│ (Hosted)         │\n└──────────────────┘\n```\n\nSimDoc provides MCP tools to search scientific simulation documentation. Just add the endpoint to your AI client and start asking questions.\n\n---\n\n## 🐛 Troubleshooting\n\n### MCP tools not appearing in your AI client\n\n1. **Verify config file location and syntax**\n   ```bash\n   # Claude Desktop (macOS)\n   cat ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n   # Validate JSON syntax\n   python3 -m json.tool \u003c config.json\n   ```\n\n2. **Check the URL is correct**\n   - Should be: `https://simdoc.subspace-lab.com/sse`\n   - Common mistake: Using `http://` instead of `https://`\n\n3. **Restart your AI client completely**\n   ```bash\n   # Claude Desktop (macOS)\n   killall Claude \u0026\u0026 open -a Claude\n   ```\n\n4. **Test the endpoint directly**\n   ```bash\n   curl https://simdoc.subspace-lab.com/sse\n   # Expected: \"event: endpoint\" response\n   ```\n\n5. **Check your AI client's MCP logs**\n   - Claude Desktop (macOS): `~/Library/Logs/Claude/mcp*.log`\n   - Look for connection errors or timeout messages\n\n---\n\n## 📖 More Information\n\n- **Example Queries**: [MCP Showcase](../md-files/MCP_SHOWCASE.md) - Real usage examples\n- **Main Repository**: [SimDoc README](../README.md) - Full project overview\n- **Report Issues**: [GitHub Issues](https://github.com/your-org/simdoc/issues)\n\n---\n\n## 🤝 Contributing\n\nContributions welcome! See the main repository for guidelines.\n\n---\n\n## 📝 License\n\nMIT License - see LICENSE file for details.\n\n---\n\n**Built with** ❤️ **for the scientific computing community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubspace-lab%2Fsimdoc-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubspace-lab%2Fsimdoc-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubspace-lab%2Fsimdoc-mcp/lists"}