@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