README_MCP.md

CodeBank MCP Server

This is a Model Context Protocol (MCP) server for CodeBank, allowing AI agents to interact with code bases and generate code bank summaries.

Installation

Make sure you have Rust and Cargo installed, then install the cb-mcp binary by running:

cargo install codebank

The binary will be in ~/.cargo/bin/cb-mcp.

Usage

Running as an MCP Server

STDIO Mode

Please add the following to your the mcp config of cursor or claude:

"cb-mcp": {
  "command": "/Path/to/cb-mcp",
  "args": [
    "stdio"
  ]
}

Your mcp client will run the following command (if they didn't, you can run it manually):

cb-mcp stdio

This allows AI agents to interact with the server through standard input/output.

SSE Mode

Please add the following to your the mcp config of cursor or claude:

"cb-mcp": {
      "url": "http://localhost:3000/sse"
    }

Run as an MCP server in SSE (Server-Sent Events) mode on a specific port:

cb-mcp sse --port 3000

This starts a web server that AI agents can interact with.

Server API

When running in server mode, the following tools are available to AI agents:

• gen: Generate code bank from source code
• gen_file: Generate code bank and save to file

Strategies

CodeBank supports different generation strategies:

• default: Includes all code from the specified path
• summary: Includes only public interfaces, function signatures without bodies
• no-tests: Includes all code except test cases