Devvit Mcp

devvit-mcp

用于在 Reddit 开发者平台上编写应用的配套 MCP 服务。

安装

将以下内容添加到你选择的编辑器或大模型的 mcp.json 中。

{
  "mcpServers": {
    "devvit-mcp": {
      "command": "npx",
      "args": ["-y", "@devvit/mcp"]
    }
  }
}

选择退出遥测

{
  "mcpServers": {
    "devvit-mcp": {
      "command": "npx",
      "args": ["-y", "@devvit/mcp"],
      "env": {
        "DEVVIT_DISABLE_METRICS": "true"
      }
    }
  }
}

开发 MCP 服务

git clone [email protected]:reddit/devvit-mcp.git

cd devvit-mcp

nvm use

npm install

npm run dev

如果你想在其他项目中测试 MCP 服务，请传入 Node 运行时的完整路径，以及你机器上 /dist/index.js 的位置。

• Node 路径：which node
• Dist：在 devvit-mcp 根目录运行 pwd，再加上 /dist/index.js

{
  "mcpServers": {
    "devvit-mcp": {
      "command": "/Users/marcus.wood/.nvm/versions/node/v22.13.0/bin/node",
      "args": ["/Users/marcus.wood/open-source/devvit-mcp/dist/index.js"]
    }
  }
}

MCP 注意事项

• 如果你要调试应用，请勿在关键执行路径中使用 console.log。你会看到类似 Unexpected token 'a', " at Anthrop"... is not valid JSON 的奇怪错误消息。我们已对 logger 进行封装，会自动为你处理这种转换。
• 通过 MCP 运行时，在 MCP 中只能使用 console.error 进行日志记录。

调试

• 最佳体验是使用 npm run dev，前往工具列表，列出工具并触发它们。

• 要在实时环境中查看日志并进行测试，请使用 Claude desktop 并在其中连接 MCP。它们会在你的机器上生成报告错误的日志文件。你可以使用 VSCode 打开这些文件，或运行 tail 命令查看。

• 如果你看到类似这样的内容：

Error: Server does not support logging (required for notifications/message)
    at Server.assertNotificationCapability

你需要为 new MCPServer 添加相应的功能。请使用此永久链接查看应该添加哪个键。

版本管理

此软件包使用由 CI/CD 管理的自动版本管理。package.json 中的版本号只是占位符，会在发布流程中自动更新。请查看 git 标签以了解实际发布的版本。

致谢

非常感谢 Arabold 开源了 docs-mcp-server。本项目的部分代码深受此库启发。如果你需要其他文档服务，请使用它！