曲速驱动mcp
MCP服务器，将WarpDrive和EmberData文档作为工具公开。从Cursor、Claude Desktop或任何MCP客户端使用它，这样助手就可以查找真实的文档，而不是猜测。
从以下位置提取文档 canary.warp-drive.io 并缓存30分钟。所有工具都是只读的（没有副作用）。
要求： Node.js 18或更高版本。
______________________________________________________________________
安装
将服务器添加到MCP配置中。如果使用，则不进行全局安装 npx.
使用npx（推荐）：
{
"mcpServers": {
"warp-drive": {
"command": "npx",
"args": ["-y", "warp-drive-mcp"]
}
}
}使用本地构建： 使用完整路径 node 并到 dist/index.js 因此客户端可以找到它们（例如，如果您使用Volta/nvm并从Dock启动应用程序）：
{
"mcpServers": {
"warp-drive": {
"command": "/path/to/node",
"args": ["/path/to/warp-drive-mcp/dist/index.js"]
}
}
}配置文件位置：
| 客户端 | 配置路径 |
|---|---|
| 光标 | ~/.cursor/mcp.json （Mac/Linux）， %APPDATA%\Cursor\mcp.json （Windows） |
| 克劳德桌面 | ~/Library/Application Support/Claude/claude_desktop_config.json （Mac）， %APPDATA%\Claude\claude_desktop_config.json （Windows） |
更改配置后重新启动客户端。服务器名称旁边的绿点表示它正在运行。
故障排除
spawn node ENOENT或spawn npx ENOENT--客户找不到node/npx在其PATH中（从Dock/Photlight启动应用程序时很常见）。在中使用完整路径command例如。/Users/you/.volta/bin/node或/Users/you/.volta/bin/npx.快跑which node或which npx在终端中获取您的路径，然后将其放入配置中。- 红点/服务器未启动 --检查客户的MCP或开发人员日志以了解确切的错误。确认配置键为
mcpServers（光标，克劳德桌面）和路径dist/index.js使用本地构建时是绝对的。 - 错误或旧文档 --文档被缓存30分钟。重新启动服务器（或客户端）以强制重新获取。
______________________________________________________________________
工具
服务器公开了5个工具。客户（Cursor、Claude等）根据您的问题决定何时给他们打电话。
search_warp_drive_docs
按关键字搜索文档。将其用于API名称、概念或“如何使用X”问题。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
query | string | -- | 要搜索什么（例如。 RequestManager, Store.request, JSONAPICache setup, React hooks) |
maxResults | number | 5 | 要返回多少个文档节（1-10） |
何时使用： 在编写WarpDrive代码之前，或者当用户询问特定的API或概念时。
______________________________________________________________________
get_warp_drive_package
获取一个包裹的完整文档内容（例如。 @warp-drive/core, @warp-drive/react).
| 参数 | 类型 | 说明 |
|---|---|---|
packageName | string | 包名称，例如。 @warp-drive/core, @warp-drive/json-api, @ember-data/store |
何时使用： 当你需要一个包的全貌，而不仅仅是一个搜索片段时。
______________________________________________________________________
get_warp_drive_overview
返回所有WarpDrive包的高级概述（每个包的用途）。
没有参数。
何时使用： “什么是WarpDrive？”，“我应该为X使用哪个包？”，或者在启动新项目时，你不确定包的布局。
______________________________________________________________________
get_warp_drive_guide
搜索指南和烹饪书风格的文档（教程、“如何”内容）。
| 参数 | 类型 | 说明 |
|---|---|---|
topic | string | 要查找的主题（例如。 auth handler, request builder, caching, React setup, migration from adapters) |
何时使用： “如何设置…”、“如何编写…”或分步/迁移问题。
______________________________________________________________________
check_warp_drive_注意事项
检查API或程序包是否已弃用，以及要使用什么。
| 参数 | 类型 | 说明 |
|---|---|---|
apiName | 字符串 | API、包或类名称（例如。 StableRecordIdentifier, @ember-data/request, findAll builder) |
何时使用： 用户看到弃用警告，或者您正在接触旧版 @ember-data/* 代码，并希望现代的替代品。
______________________________________________________________________
光标：提示助手使用工具
在使用WarpDrive的项目中，您可以添加一个游标规则，以便助手在相关时调用这些工具。创建 .cursor/rules （或使用现有的规则文件）并添加以下内容：
When working with WarpDrive (@warp-drive/* or @ember-data/*):
- Call search_warp_drive_docs before writing WarpDrive code.
- Use get_warp_drive_guide for “how to” and setup questions.
- Use check_warp_drive_deprecations for legacy @ember-data/* APIs.
- Don’t guess APIs; look them up first.______________________________________________________________________
发展
git clone https://github.com/MehulKChaudhari/warp-drive-mcp
cd warp-drive-mcp
npm install # or pnpm install
npm run build # if you used pnpm: pnpm run build- 运行内置服务器：
node dist/index.js或pnpm start - 开发模式（观看）：
npm run dev或pnpm dev
要将MCP配置指向此存储库，请设置 command 到你的 node 二进制和 args 走向绝对的道路 warp-drive-mcp/dist/index.js.
______________________________________________________________________
运作原理
服务器是一个stdio MCP进程。客户端启动它，并使用JSON-RPC通过stdin/stdout进行对话。当助手需要文档时，它会调用其中一个工具；服务器获取 https://canary.warp-drive.io/llms-full.txt （或者如果仍然新鲜，则使用内存中的缓存），然后搜索或过滤该内容并返回相关位。所有这些都生活在 src/index.ts.
______________________________________________________________________
链接
______________________________________________________________________
贡献
欢迎提交Bug报告和PR。项目存储库中的未解决问题和PR（请参见 package.json 对于URL）。
______________________________________________________________________
许可证
麻省理工学院