{"_id":"@caleblawson/mcp-docs-server","name":"@caleblawson/mcp-docs-server","dist-tags":{"latest":"0.13.1"},"versions":{"0.13.1":{"name":"@caleblawson/mcp-docs-server","version":"0.13.1","description":"MCP server for accessing Mastra.ai documentation, changelogs, and news.","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"mcp-docs-server":"dist/stdio.js"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./package.json":"./package.json"},"keywords":[],"author":"","license":"Elastic-2.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","date-fns":"^4.1.0","exit-hook":"^4.0.0","jsdom":"^26.1.0","turndown":"^7.2.0","uuid":"^11.1.0","zod":"^3.25.57","zod-to-json-schema":"^3.24.5","@mastra/mcp":"npm:@caleblawson/mcp@^0.10.4"},"devDependencies":{"@hono/node-server":"^1.14.4","@types/jsdom":"^21.1.7","@types/node":"^20.19.0","@types/turndown":"^5.0.5","@wong2/mcp-cli":"^1.10.0","cross-env":"^7.0.3","eslint":"^9.28.0","hono":"^4.7.11","tsup":"^8.5.0","tsx":"^4.19.4","typescript":"^5.8.3","vitest":"^3.2.3","@mastra/core":"npm:@caleblawson/core@0.10.7-alpha.0","@internal/lint":"0.0.13"},"peerDependencies":{"@mastra/core":"^0.10.0-alpha.0"},"scripts":{"prepare-docs":"cross-env PREPARE=true node dist/prepare-docs/prepare.js","build:cli":"tsup src/stdio.ts src/prepare-docs/prepare.ts --format esm --experimental-dts --treeshake=smallest --splitting","pretest":"pnpm turbo build --filter @mastra/mcp-docs-server","test":"vitest run","lint":"eslint ."},"gitHead":"c31e90130a5c9765c23f688ecea70adc6164543d","_id":"@caleblawson/mcp-docs-server@0.13.1","_integrity":"sha512-LAkcY5tq45XkP5nL9gm/FdUzs9u/zDt33TnsDqZ+M+1/MjPf5Fi3nEDSuk1GWzjJndiG7YZLxpy9QvdgGKfDRw==","_resolved":"C:\\Users\\caleb\\AppData\\Local\\Temp\\fbfca5c9716fcab96b1beb2185488d8c\\caleblawson-mcp-docs-server-0.13.1.tgz","_from":"file:caleblawson-mcp-docs-server-0.13.1.tgz","_nodeVersion":"21.2.0","_npmVersion":"10.2.3","dist":{"integrity":"sha512-LAkcY5tq45XkP5nL9gm/FdUzs9u/zDt33TnsDqZ+M+1/MjPf5Fi3nEDSuk1GWzjJndiG7YZLxpy9QvdgGKfDRw==","shasum":"e513bb7c74beff540b2f84557b81a8ffaec029f7","tarball":"https://registry.npmjs.org/@caleblawson/mcp-docs-server/-/mcp-docs-server-0.13.1.tgz","fileCount":415,"unpackedSize":2085030,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDYmyL2yZFqo18aBJ43G9b9L98YjvHUn4UHOcJfRdNJtwIhALWBdAESdHhoewSrX6YlIL2uUvByz2HoYaQuj686sclb"}]},"_npmUser":{"name":"caleblawson","email":"caleb.lawson@dynapt.com","actor":{"name":"caleblawson","email":"caleb.lawson@dynapt.com","type":"user"}},"directories":{},"maintainers":[{"name":"caleblawson","email":"caleb.lawson@dynapt.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-docs-server_0.13.1_1750619760884_0.19907190933779972"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-22T19:16:00.811Z","0.13.1":"2025-06-22T19:16:01.183Z","modified":"2025-06-22T19:16:01.427Z"},"maintainers":[{"name":"caleblawson","email":"caleb.lawson@dynapt.com"}],"description":"MCP server for accessing Mastra.ai documentation, changelogs, and news.","keywords":[],"license":"Elastic-2.0","readme":"# @mastra/mcp-docs-server\r\n\r\nA Model Context Protocol (MCP) server that provides AI assistants with direct access to Mastra.ai's complete knowledge base. This includes comprehensive documentation with MDX support, a collection of production-ready code examples, technical blog posts, and detailed package changelogs. The server integrates with popular AI development environments like Cursor and Windsurf, as well as Mastra agents, making it easy to build documentation-aware AI assistants that can provide accurate, up-to-date information about Mastra.ai's ecosystem.\r\n\r\n## Installation\r\n\r\n### In Cursor\r\n\r\nCreate or update `.cursor/mcp.json` in your project root:\r\n\r\nMacOS/Linux\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mastra\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@mastra/mcp-docs-server\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nWindows\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mastra\": {\r\n      \"command\": \"cmd\",\r\n      \"args\": [\"/c\", \"npx\", \"-y\", \"@mastra/mcp-docs-server\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nThis will make all Mastra documentation tools available in your Cursor workspace.\r\nNote that the MCP server wont be enabled by default. You'll need to go to Cursor settings -> MCP settings and click \"enable\" on the Mastra MCP server.\r\n\r\n### In Windsurf\r\n\r\nCreate or update `~/.codeium/windsurf/mcp_config.json`:\r\n\r\nMacOS/Linux\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mastra\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@mastra/mcp-docs-server\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nWindows\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mastra\": {\r\n      \"command\": \"cmd\",\r\n      \"args\": [\"/c\", \"npx\", \"-y\", \"@mastra/mcp-docs-server\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nThis will make all Mastra documentation tools available in your Windsurf workspace.\r\nNote that Windsurf MCP tool calling doesn't work very well. You will need to fully quit and re-open Windsurf after adding this.\r\nIf a tool call fails you will need to go into Windsurf MCP settings and re-start the MCP server.\r\n\r\n### In a Mastra Agent\r\n\r\n```typescript\r\nimport { MCPClient } from '@mastra/mcp';\r\nimport { Agent } from '@mastra/core/agent';\r\nimport { openai } from '@ai-sdk/openai';\r\n\r\n// Configure MCP with the docs server\r\nconst mcp = new MCPClient({\r\n  servers: {\r\n    mastra: {\r\n      command: 'npx',\r\n      args: ['-y', '@mastra/mcp-docs-server'],\r\n    },\r\n  },\r\n});\r\n\r\n// Create an agent with access to all documentation tools\r\nconst agent = new Agent({\r\n  name: 'Documentation Assistant',\r\n  instructions: 'You help users find and understand Mastra.ai documentation.',\r\n  model: openai('gpt-4'),\r\n  tools: await mcp.getTools(),\r\n});\r\n\r\n// Or use toolsets dynamically in generate/stream\r\nconst response = await agent.stream('Show me the quick start example', {\r\n  toolsets: await mcp.getToolsets(),\r\n});\r\n```\r\n\r\n## Tools\r\n\r\n### Documentation Tool (`mastraDocs`)\r\n\r\n- Get Mastra.ai documentation by requesting specific paths\r\n- Explore both general guides and API reference documentation\r\n- Automatically lists available paths when a requested path isn't found\r\n\r\n### Examples Tool (`mastraExamples`)\r\n\r\n- Access code examples showing Mastra.ai implementation patterns\r\n- List all available examples\r\n- Get detailed source code for specific examples\r\n\r\n### Blog Tool (`mastraBlog`)\r\n\r\n- Access technical blog posts and articles\r\n- Posts are properly formatted with code block handling\r\n- Supports various date formats in blog metadata\r\n\r\n### Changes Tool (`mastraChanges`)\r\n\r\n- Access package changelogs\r\n- List all available package changelogs\r\n- Get detailed changelog content for specific packages\r\n","readmeFilename":"README.md","_rev":"1-933c2681595bfdd3ce98276b25d4c0ae"}