@pokooo/bb-api-mcp

Model Context Protocol (MCP) server for bitbank-api — exposes the TypeScript SDK source to AI assistants via tools and resources.

Tools

| Tool | Description | |------|-------------| | list_sdk_files | List all TypeScript source files in the bitbank-api SDK | | get_sdk_file | Return the full content of a specific SDK source file | | search_sdk | Search across all SDK source files for a keyword (case-insensitive, with file name and line number) | | get_api_overview | Return a structured overview of all client classes and their public methods |

Resources

| URI | Description | |-----|-------------| | bitbank-api://overview | Structured summary of all SDK clients and their methods | | bitbank-api://source/<path> | Raw content of an individual SDK source file |

Installation

pnpm install
pnpm build

Requirements: Node.js 18+, and the bitbank-api repository cloned locally.

Quick Start

By default the server looks for the SDK at ../bitbank-api/src relative to this package. Override with an environment variable:

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

Claude Desktop

Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Configuration

| Environment Variable | Default | Description | |----------------------|---------|-------------| | BITBANK_API_SRC_PATH | ../bitbank-api/src | Absolute path to the bitbank-api SDK src directory |

Development

pnpm dev    # Watch mode (tsc --watch)
pnpm build  # Compile TypeScript
pnpm start  # Start the server

License

MIT