Devvit Mcp

devvit-mcp

Reddit の開発者プラットフォームでアプリケーションを作成するための、補助的な MCP サーバーです。

インストール

お好みのエディターまたは LLM の 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 タグで確認してください。

クレジット

docs-mcp-server をオープンソース化してくださった Arabold に、心より感謝します。このコードの一部は、このライブラリから大きな影響を受けています。他のドキュメントサーバーが必要な場合は、ぜひご利用ください。