{"_id":"@ariadnejs/mcp","_rev":"6-5729c315d05475eb7dd0237f0eadfce0","name":"@ariadnejs/mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@ariadnejs/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"author":{"name":"Chuck"},"license":"ISC","_id":"@ariadnejs/mcp@0.1.0","maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"homepage":"https://github.com/CRJFisher/ariadne#readme","bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"bin":{"ariadne-mcp":"dist/server.js"},"dist":{"shasum":"f8c0e632be96e982911f21d1bff1841b7b31c52a","tarball":"https://registry.npmjs.org/@ariadnejs/mcp/-/mcp-0.1.0.tgz","fileCount":15,"integrity":"sha512-5JScBnBXEYw/M1S1mx1Er5qwG3cLKwac0xJqb4TU9R8k9HABVSNn9tiV9HhWsquw2qKB4Uz+ILE2zzjP2dEj2Q==","signatures":[{"sig":"MEQCIBJHv240IZZGIFLlzUeIwnFSHWJU2ouizxV+FwqwgpPpAiByEA2OTwIkr7KxxZoP9OkTvn/Y/PUqOOaqPHwHKdSaeA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34520},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"6c48b23a7daf053e8cbc26d760940614a9de9c50","scripts":{"test":"vitest run","build":"tsc && chmod +x dist/server.js","clean":"rm -rf dist","start":"node dist/server.js","test:ui":"vitest --ui","test:coverage":"vitest --coverage","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"crjfisher","email":"crjfisher@gmail.com"},"repository":{"url":"git+https://github.com/CRJFisher/ariadne.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.22.0","@ariadnejs/core":"0.5.15","@ariadnejs/types":"0.5.15","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","@vitest/ui":"^3.2.4","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1753799154717_0.4624781893264518","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ariadnejs/mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"author":{"name":"Chuck"},"license":"ISC","_id":"@ariadnejs/mcp@0.1.1","maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"homepage":"https://github.com/CRJFisher/ariadne#readme","bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"bin":{"ariadne-mcp":"dist/server.js"},"dist":{"shasum":"93afc214fa45eec7bf403ae610a2102342781954","tarball":"https://registry.npmjs.org/@ariadnejs/mcp/-/mcp-0.1.1.tgz","fileCount":15,"integrity":"sha512-xt/Q8KzRys9Ugs/V4blfGab5vD9uuF/a+l0g5SLICL4UPA/EjxTC2n52hwz+Lz/jG0faYRm7uKmYT0Pitm+T8Q==","signatures":[{"sig":"MEUCICxPuwCpPMuCkCSEtbFEeuL2F15Od5Z51TkV87xbj7aaAiEA0kTjPmPQONZnrGqr0YRxcVYPkA0MR2DIrAJ/VM7QD4Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34520},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"c5be2015b217d0e09ee6ef50a148ddba949ea4d2","scripts":{"test":"vitest run","build":"tsc && chmod +x dist/server.js","clean":"rm -rf dist","start":"node dist/server.js","test:ui":"vitest --ui","test:coverage":"vitest --coverage","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"crjfisher","email":"crjfisher@gmail.com"},"repository":{"url":"git+https://github.com/CRJFisher/ariadne.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.22.0","@ariadnejs/core":"0.5.16","@ariadnejs/types":"0.5.15","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","@vitest/ui":"^3.2.4","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1753889051697_0.20303985497565202","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ariadnejs/mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"author":{"name":"Chuck"},"license":"ISC","_id":"@ariadnejs/mcp@0.1.2","maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"homepage":"https://github.com/CRJFisher/ariadne#readme","bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"bin":{"ariadne-mcp":"dist/server.js"},"dist":{"shasum":"ac087c16b765dc8a882137311523a3a8c78ebe0c","tarball":"https://registry.npmjs.org/@ariadnejs/mcp/-/mcp-0.1.2.tgz","fileCount":23,"integrity":"sha512-ATxWlaAYcMUQI9kb5glSSaCNbPA95K/yNjXPNTiFLcjOBmdyaNHlqhIeQ6SoV/4TJm5NJvj7cYsULw0LJ50E0g==","signatures":[{"sig":"MEYCIQCpoh39K/2fzHuipgZ1PImCI+5p7OuFREGWU37SO4T6YgIhAKfCpgIfaMCVV/CnT6971HmOsijFypwGsrN8tEj4Lndl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66264},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"95976c67628a0866d26ee6afce9100212e72c846","scripts":{"test":"vitest run","build":"tsc && chmod +x dist/server.js","clean":"rm -rf dist","start":"node dist/server.js","test:ui":"vitest --ui","prebuild":"npm run update-version","test:coverage":"vitest --coverage","prepublishOnly":"npm run build && npm test","update-version":"node scripts/update-version.js"},"_npmUser":{"name":"crjfisher","email":"crjfisher@gmail.com"},"repository":{"url":"git+https://github.com/CRJFisher/ariadne.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.22.0","@ariadnejs/core":"0.5.17","@ariadnejs/types":"0.5.15","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","@vitest/ui":"^3.2.4","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1753925687735_0.15818714521315824","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ariadnejs/mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"author":{"name":"Chuck"},"license":"ISC","_id":"@ariadnejs/mcp@0.1.3","maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"homepage":"https://github.com/CRJFisher/ariadne#readme","bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"bin":{"ariadne-mcp":"dist/server.js"},"dist":{"shasum":"59bc6f4d2bb0134baaf9761a20b2382ed4c7c078","tarball":"https://registry.npmjs.org/@ariadnejs/mcp/-/mcp-0.1.3.tgz","fileCount":23,"integrity":"sha512-kqKaClvGsc6Q394m8LQ0mz1kJumnmYyFP6+6gati1pXcuZV87gOGmDPI+FGRwWzpywro+7qLkZ/5Nd2fJ8EjwQ==","signatures":[{"sig":"MEUCIGs2p+RffmhO2vfjmD98JVNv3v6xRrYp+m69o3zS+0cuAiEA5oJ31olzvec45GAxTVXh3FTqc0mqf1enX5XV/niHhes=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57009},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"0bacc7f9cf9f815c31679416ca2ff58eda9086ea","scripts":{"test":"vitest run","build":"tsc && chmod +x dist/server.js","clean":"rm -rf dist","start":"node dist/server.js","test:ui":"vitest --ui","prebuild":"npm run update-version","test:coverage":"vitest --coverage","prepublishOnly":"npm run build && npm test","update-version":"node scripts/update-version.js"},"_npmUser":{"name":"crjfisher","email":"crjfisher@gmail.com"},"repository":{"url":"git+https://github.com/CRJFisher/ariadne.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.22.0","@ariadnejs/core":"0.5.18","@ariadnejs/types":"0.5.15","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","@vitest/ui":"^3.2.4","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.3_1753963958842_0.9834429303350585","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@ariadnejs/mcp","version":"0.1.5","keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"author":{"name":"Chuck"},"license":"ISC","_id":"@ariadnejs/mcp@0.1.5","maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"homepage":"https://github.com/CRJFisher/ariadne#readme","bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"bin":{"ariadne-mcp":"dist/server.js"},"dist":{"shasum":"dae2d1e10b29b95b701c39c6e5455cd10581c658","tarball":"https://registry.npmjs.org/@ariadnejs/mcp/-/mcp-0.1.5.tgz","fileCount":23,"integrity":"sha512-oRxCRzJOqtgq7ifntsJ+nBJjgNb01S3yDJrq0P7ulynloTVn+pLDRgizDyeVwEh9ij8bOOuS/3kg1TH899fPfQ==","signatures":[{"sig":"MEYCIQCAxJuoM/qjgiicuVvZi3XwGLniLatPWvGrYkUxssNOkwIhANMNpO1NIYkujzFBnX7kY8cuK44Sq2qQVQSOeeF8O0Xk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":80245},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"78c92335eb5f018291bb045e92b2a8abe861be32","scripts":{"test":"vitest run","build":"tsc && chmod +x dist/server.js","clean":"rm -rf dist","start":"node dist/server.js","test:ui":"vitest --ui","prebuild":"npm run update-version","test:coverage":"vitest --coverage","prepublishOnly":"npm run build && npm test","update-version":"node scripts/update-version.js"},"_npmUser":{"name":"crjfisher","email":"crjfisher@gmail.com"},"repository":{"url":"git+https://github.com/CRJFisher/ariadne.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.22.0","@ariadnejs/core":"0.7.0","@ariadnejs/types":"0.5.15","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","@vitest/ui":"^3.2.4","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.5_1754578903372_0.46334722475102885","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@ariadnejs/mcp","version":"0.2.0","description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","main":"dist/index.js","types":"dist/index.d.ts","bin":{"ariadne-mcp":"dist/server.js","ariadne-analytics":"dist/scripts/ariadne_analytics.js"},"keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"author":{"name":"Chuck"},"license":"ISC","repository":{"type":"git","url":"git+https://github.com/CRJFisher/ariadne.git","directory":"packages/mcp"},"bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"homepage":"https://github.com/CRJFisher/ariadne#readme","publishConfig":{"access":"public","provenance":true},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","better-sqlite3":"^11.0.0","chokidar":"^3.6.0","zod":"^3.22.0","@ariadnejs/core":"0.8.0","@ariadnejs/types":"0.8.0"},"devDependencies":{"@types/better-sqlite3":"^7.6.0","@types/node":"^20.0.0","@vitest/ui":"^3.2.4","vitest":"^3.2.4"},"scripts":{"update-version":"node scripts/update-version.js","prebuild":"npm run update-version","build":"tsc && chmod +x dist/server.js","test":"vitest run","test:ui":"vitest --ui","test:coverage":"vitest --coverage","clean":"rm -rf dist","start":"node dist/server.js"},"_id":"@ariadnejs/mcp@0.2.0","_integrity":"sha512-RC9xPOcdXzs3iBAs2pFUrEgZUvZkZVI16OMXrY5jHBpg2roXGfr8Zld7WAkNlNkiEjBxpGk4SKKEFHTw+HjR7g==","_resolved":"/tmp/668b99a67720380e42c20a26b87a0075/ariadnejs-mcp-0.2.0.tgz","_from":"file:ariadnejs-mcp-0.2.0.tgz","_nodeVersion":"22.22.0","_npmVersion":"11.10.1","dist":{"integrity":"sha512-RC9xPOcdXzs3iBAs2pFUrEgZUvZkZVI16OMXrY5jHBpg2roXGfr8Zld7WAkNlNkiEjBxpGk4SKKEFHTw+HjR7g==","shasum":"eacebcd158bda4093a4a9db9264ca413a49212ea","tarball":"https://registry.npmjs.org/@ariadnejs/mcp/-/mcp-0.2.0.tgz","fileCount":55,"unpackedSize":158370,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ariadnejs%2fmcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEMCIC2fPr7lrNaN+Nr2pXzXK/r+uqANBkHHmuWR/M0g9mcUAh96hNDhalT7BBQqbjl0LaEfPyt/cH2N8tJ2EVNtBzqg"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:afbcfbe2-f0d0-41e4-8df4-7ede6538f29e"}},"directories":{},"maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.0_1771623684870_0.15217987985731485"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-29T14:25:54.625Z","modified":"2026-02-20T21:41:25.412Z","0.1.0":"2025-07-29T14:25:54.882Z","0.1.1":"2025-07-30T15:24:11.882Z","0.1.2":"2025-07-31T01:34:47.970Z","0.1.3":"2025-07-31T12:12:39.011Z","0.1.5":"2025-08-07T15:01:43.569Z","0.2.0":"2026-02-20T21:41:25.025Z"},"bugs":{"url":"https://github.com/CRJFisher/ariadne/issues"},"author":{"name":"Chuck"},"license":"ISC","homepage":"https://github.com/CRJFisher/ariadne#readme","keywords":["mcp","model-context-protocol","ai","code-intelligence","ariadne","tree-sitter","refactoring","code-analysis"],"repository":{"type":"git","url":"git+https://github.com/CRJFisher/ariadne.git","directory":"packages/mcp"},"description":"Model Context Protocol server for Ariadne - Expose code intelligence capabilities to AI agents","maintainers":[{"name":"crjfisher","email":"crjfisher@gmail.com"}],"readme":"# @ariadnejs/mcp\n\nModel Context Protocol server for Ariadne - Give AI coding assistants powerful code intelligence capabilities.\n\n## Overview\n\nThis package provides an MCP (Model Context Protocol) server that exposes Ariadne's code intelligence features to AI assistants like Claude, Cursor, Continue, and other MCP-compatible tools. It enables AI agents to understand your codebase deeply by analyzing code structure, finding definitions and references, tracking inheritance relationships, and understanding function call graphs.\n\n### Key Benefits\n\n- **Deep Code Understanding**: AI can navigate your codebase like an experienced developer\n- **Accurate Symbol Resolution**: Find exact definitions and usages across files\n- **Context-Aware Assistance**: AI understands inheritance, implementations, and call relationships\n- **Multi-Language Support**: Works with JavaScript, TypeScript, Python, and Rust\n\n## Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g @ariadnejs/mcp\n```\n\n### Project-Specific Installation\n\n```bash\nnpm install --save-dev @ariadnejs/mcp\n```\n\n## Quick Start\n\n### Step 1: Install the MCP Server\n\n```bash\nnpm install -g @ariadnejs/mcp\n```\n\n### Step 2: Configure Your AI Assistant\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json` (usually in `~/Library/Application Support/Claude/` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"ariadne\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ariadnejs/mcp\"],\n      \"env\": {\n        \"PROJECT_PATH\": \"/path/to/your/project\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to your `.cursor/mcp/config.json` in your project root:\n\n```json\n{\n  \"servers\": {\n    \"ariadne\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ariadnejs/mcp\"]\n    }\n  }\n}\n```\n\n#### Continue\n\nAdd to your `~/.continue/config.json`:\n\n```json\n{\n  \"models\": [...],\n  \"mcpServers\": {\n    \"ariadne\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ariadnejs/mcp\"]\n    }\n  }\n}\n```\n\nFor more detailed setup instructions, see the [Setup Guide](./SETUP.md).\n\n## Usage\n\n### Running the MCP Server\n\n```bash\nnpx ariadne-mcp\n```\n\nOr programmatically:\n\n```javascript\nimport { startServer } from '@ariadnejs/mcp';\n\nstartServer({\n  projectPath: './my-project'\n});\n```\n\n### Available Tool\n\nThe MCP server currently provides one powerful context-oriented tool:\n\n#### `get_symbol_context`\n\nGet comprehensive information about any symbol by name - no file position needed!\n\n```typescript\n// Example usage by AI:\n{\n  \"tool\": \"get_symbol_context\",\n  \"arguments\": {\n    \"symbol\": \"processPayment\",\n    \"includeTests\": true\n  }\n}\n```\n\nParameters:\n\n- `symbol` (required): Name of the function, class, or variable to look up\n- `searchScope` (optional): \"file\" | \"project\" | \"dependencies\" (default: \"project\")\n- `includeTests` (optional): Whether to include test file references (default: false)\n\nReturns:\n\n- Full function/class implementation with documentation\n- Usage statistics (references, imports, tests)\n- Call relationships (calls/called by)\n- Class inheritance and interface implementations\n- File location and signature\n\nComing soon:\n\n- `get_call_graph` - Analyze function call relationships\n- `get_references` - Find all references to a symbol\n- `preview_refactor` - Preview the impact of refactoring changes\n\n## Example Use Cases\n\n### For AI Assistants\n\nOnce configured, AI assistants can help you with:\n\n- **Code Navigation**: \"Show me the implementation of the authenticate function\"\n- **Impact Analysis**: \"What functions would be affected if I change the User class?\"\n- **Code Understanding**: \"Explain how the PaymentService interacts with other services\"\n- **Refactoring**: \"Find all places where the deprecated processOrder function is used\"\n- **Architecture Review**: \"Show me the call graph starting from the main API endpoints\"\n- **Test Coverage**: \"Which functions in the auth module don't have tests?\"\n\n### For Developers\n\nThe MCP server helps AI assistants provide better:\n\n- **Code Reviews**: Understanding the full context of changes\n- **Bug Investigation**: Tracing function calls and data flow\n- **Documentation**: Generating accurate docs based on actual code structure\n- **Refactoring Suggestions**: Safe rename and move operations\n- **Architecture Decisions**: Understanding existing patterns and dependencies\n\n## Configuration\n\n### Environment Variables\n\n- `PROJECT_PATH`: The root directory of your project (defaults to current working directory)\n- `DEBUG_LOG_FILE`: Path to a file for debug logging (optional). When set, diagnostic messages are written to this file in addition to stderr.\n\n### Project-Specific Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"ariadne\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ariadnejs/mcp\"],\n      \"env\": {\n        \"PROJECT_PATH\": \"/path/to/your/project\",\n        \"DEBUG_LOG_FILE\": \"/tmp/ariadne-debug.log\"\n      }\n    }\n  }\n}\n```\n\n## Supported Languages\n\n- ✅ JavaScript (including JSX)\n- ✅ TypeScript (including TSX)\n- ✅ Python\n- ✅ Rust\n- 🚧 More languages coming soon (Go, Java, C/C++, etc.)\n\n## Version Compatibility\n\nThis package requires:\n\n- `@ariadnejs/core` >= 0.5.15\n- `@ariadnejs/types` >= 0.5.15\n\nThe MCP package versions independently from core packages. Check the [releases page](https://github.com/CRJFisher/ariadne/releases) for compatibility information.\n\n## Troubleshooting\n\n### Common Issues\n\n**MCP server not connecting**\n\n- Check that `@ariadnejs/mcp` is installed globally: `npm list -g @ariadnejs/mcp`\n- Verify your AI assistant's config file syntax is correct\n- Restart your AI assistant after configuration changes\n\n**\"Symbol not found\" errors**\n\n- Ensure `PROJECT_PATH` points to your project root\n- Check that your project files are saved\n- Verify the language is supported (JS/TS/Python/Rust)\n\n**Performance issues**\n\n- Large codebases may take time for initial indexing\n- Exclude `node_modules` and build directories if possible\n- Consider using project-specific installation for better caching\n\n### Debug Mode\n\nEnable file logging to troubleshoot issues:\n\n```json\n{\n  \"env\": {\n    \"DEBUG_LOG_FILE\": \"/tmp/ariadne-debug.log\"\n  }\n}\n```\n\nThen check the log file for diagnostic messages:\n\n```bash\ntail -f /tmp/ariadne-debug.log\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n\n# Start development server\nnpm start\n```\n\n### Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md) for details.\n\n## License\n\nISC\n","readmeFilename":"README.md"}