Skip to main content

BB API MCP Server

Model Context Protocol (MCP) サーバーです。@pokooo/bb-api SDK のソースコードを AI アシスタントに公開し、ツールとリソースを通じて SDK の内容を参照・検索できるようにします。

インストール​

npm install -g @okooo/bb-api-mcp
# または
npx @okooo/bb-api-mcp

要件: Node.js 18+

クイックスタート​

デフォルトでは ../bitbank-api/src（このパッケージの親ディレクトリにある bitbank-api/src）を SDK ソースパスとして参照します。別のパスを使う場合は環境変数で上書きします。

export BITBANK_API_SRC_PATH=/path/to/bb-api/src
node dist/index.js

Claude Desktop への設定​

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "bb-api-mcp": {
      "command": "npx",
      "args": ["-y", "@okooo/bb-api-mcp"],
      "env": {
        "BITBANK_API_SRC_PATH": "/path/to/bb-api/src"
      }
    }
  }
}

ローカルビルドのバイナリを直接指定する場合：

{
  "mcpServers": {
    "bb-api-mcp": {
      "command": "node",
      "args": ["/path/to/bb-api-mcp/dist/index.js"],
      "env": {
        "BITBANK_API_SRC_PATH": "/path/to/bb-api/src"
      }
    }
  }
}

設定​

環境変数デフォルト説明
BITBANK_API_SRC_PATH../bitbank-api/src@pokooo/bb-api の src ディレクトリへの絶対パス

機能一覧​

種別名前説明
Toollist_sdk_filesSDK 全ソースファイルの一覧取得
Toolget_sdk_file指定ファイルの内容取得
Toolsearch_sdkSDK 全体をキーワード検索
Toolget_api_overview全クライアントとメソッドの構造化サマリー
Resourcebitbank-api://overviewSDK 全体の概要テキスト
Resourcebitbank-api://source/<path>個別ソースファイルの内容