OctoCounts MCP Server

OctoCounts MCP サーバー

OctoCounts の SLOC レポートを、AI コーディングツール（Claude、Cursor、およびあらゆる MCP クライアント）に公開します。

ツール：

• analyze_repo：公開されている GitHub リポジトリのファイル数、行数、コード、コメント、空行、言語をカウントします。
• compare_repos：公開されている 2 つの GitHub リポジトリまたは参照を比較します。

使用方法

インストール不要の npx で実行します：

{
  "mcpServers": {
    "octocounts": {
      "command": "npx",
      "args": ["-y", "octocounts-mcp"]
    }
  }
}

または、ローカルチェックアウトから実行します：

{
  "mcpServers": {
    "octocounts": {
      "command": "node",
      "args": ["/absolute/path/to/OctoCounts/mcp/src/index.js"],
      "env": {
        "OCTOCOUNTS_API_BASE": "https://api.octocounts.com"
      }
    }
  }
}

OCTOCOUNTS_API_BASE のデフォルト値は https://api.octocounts.com です。

ローカルプロトコルのスモークテスト：

node mcp/src/index.js

サーバーは、Content-Length でフレーミングされた JSON-RPC メッセージを使用して、stdio 経由で MCP を通信します。

ライセンス

MIT

信頼性の高い分析とリポジトリの宣言

どちらのツールも、任意のブール値 respect_gitattributes を受け付けます（デフォルトは false）。これを有効にすると、標準プロファイルに基づき、リポジトリで生成物およびベンダー提供ファイルとして宣言されたファイルが除外されます。比較結果には counting_policy_compatibility（same、different、unknown）が含まれ、差分が正味のサイズ変化であることが説明されます。レポートリンクには、保存済み ID とコミット SHA が固定されます。

分析リクエストでは、安全な回数に制限された再試行、ロングポーリング、および合計 5 分の期限を使用します。エラーにはジョブ ID と復旧 URL が保持されます。stdio クライアントは元の requestId を指定して notifications/cancelled を送信できます。HTTP リクエストでは、接続が切断されると待機がキャンセルされます。キャンセルによってクライアントの待機は停止しますが、受け付け済みのバックエンドジョブは引き続き完了する場合があり、後から復旧できます。保存済みのレコードはキャッシュから期限切れになる場合があります。