OpenDigger MCP Server

OpenDigger MCP サーバー

OpenDigger の高度なリポジトリー分析とインサイトをツールおよびプロンプトを通じて提供する、Model Context Protocol（MCP）サーバーです。

クイックスタート

# Setup
git clone https://github.com/X-lab2017/open-digger-mcp-server.git

# (Optional) Ensure you're on the master branch
git checkout master

cd open-digger-mcp-server && cd mcp-server
npm install
npm run build

# Start server
npm start

重要

Cursor の設定を忘れずに行ってください（.cursor/mcp.json 内のパスを更新してください）。

想定される出力：

OpenDigger MCP Server running (on stdio)...

重要

Cursor AI IDE を使用している場合、左下に MCP サーバー（open-digger-mcp）のトースト通知が表示されます。これを 有効化 すると、MCP サーバーが提供するツールとプロンプトを使い始めることができます。確認するには、Cursor Settings を開き、MCP Servers セクションを確認してください。そこに open-digger-mcp が表示されます。

サーバーが正しく動作していることをさらに確認するには、Cursor で次の項目を確認してください。

• ✅ 「open-digger-mcp」のタイトルの横にある緑の点
• ✅ サーバーのステータスに表示される**「6 tools」**
• ✅ サーバーのステータスに表示される**「3 prompts」**
• ✅ エラーメッセージや赤いインジケーターがないこと

ヒント

詳細なインストール手順と各種 IDE の設定オプションについては、Installation.md を参照してください。

---

機能

ツール（6 種類）

No.	ツール	説明
1	get_open_digger_metric	単一リポジトリーのメトリクスを取得します
2	get_open_digger_metrics_batch	複数のメトリクスを一括処理します
3	compare_repositories	複数リポジトリーの比較分析を行います
4	analyze_trends	期間ごとの成長トレンドを分析します
5	get_ecosystem_insights	エコシステムの分析とインサイトを提供します
6	server_health	システム診断と稼働状況の監視（ベータ版）

プロンプト（3 種類）

1. repo_health_analysis - リポジトリーの包括的な健全性レポート
2. repo_comparison - リポジトリーの競合分析
3. developer_insights - 開発者の活動と貢献の分析

メトリクス

• コアメトリクス：openrank、stars、forks、contributors、participants、issues_new、issues_closed、pull_requests、commits、activity

• 拡張メトリクス：technical_fork、bus_factor、releases、inactive_contributors、maintainer_count、community_activity

• その他のメトリクス：change_requests、pull_requests_accepted、pull_requests_merged、issue_comments、issue_response_time、code_change_lines、developer_network

---

💡 使用例

💠 リポジトリーの比較

Compare microsoft/vscode and facebook/react using the compare_repositories tool

💠 健全性分析

Generate a health report for microsoft/vscode using the repo_health_analysis prompt

💠 トレンド分析

Analyze the growth trends for contributors in microsoft/vscode over 2 years

---

サーバーのステータス確認

サーバーの起動後、正常に動作していることを確認してください：

# In a new terminal
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/index.js

想定される応答には、6 種類すべてのツールが一覧表示されます。

設定

環境変数（.env）

# Cache configuration (recommended)
CACHE_TTL_SECONDS=300

# Optional SSE server
SSE_PORT=3001
SSE_HOST=127.0.0.1

Cursor MCP（.cursor/mcp.json）

{
  "mcpServers": {
    "open-digger": {
      "command": "node",
      "args": ["/full/path/to/dist/index.js"],
      "cwd": "/full/path/to/project",
      "env": {
        "CACHE_TTL_SECONDS": "300"
      }
    }
  }
}

ヒント

/full/path/to/open-digger-mcp-server を実際のプロジェクトディレクトリーのパスに置き換えてください。現在のディレクトリーパスを取得するには pwd を使用します。

開発

npm run watch           # Development mode
npm run build           # Compile TypeScript
npm run clean           # Clean build files
npm run sse:test        # Test SSE server

ヒント

Cursor のほかに、VS Code、Claude Chat、公式の MCP Inspector など、他の MCP クライアントも使用できます。

トラブルシューティング

よくある問題

Cursor にサーバーが表示されない場合：

1. .cursor/mcp.json の絶対パスを確認します
2. Cursor を完全に再起動します（Cmd+Q / Alt+F4）
3. MCP Settings セクションにエラーメッセージが表示されていないか確認します

権限エラー：

chmod +x dist/index.js

ビルドエラー：

npm run clean
npm install
npm run build

キャッシュの問題：

# Clear npm cache
npm cache clean --force

# Rebuild
npm run clean && npm run build

---

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

Apache-2.0 ライセンスの詳細については、LICENSE ファイルを参照してください。