Boost Space MCP Server

What is Boost Space MCP Server about?

Boost Space MCP Server acts as a bridge between Boost.Space’s REST endpoints and clients that speak the Model Context Protocol (MCP). By running a local proxy, MCP clients can issue familiar requests while the server translates them into authenticated REST calls to Boost.Space.

How to use Boost Space MCP Server?

1. Install – via pip (pip install boostspace-mcp) or uv (uv add boostspace-mcp).
2. Run – execute python -m boostspace_mcp.server (or uv x boostspace-mcp run).
3. Configure – set the environment variables BOOSTSPACE_API_BASE (the API base URL) and BOOSTSPACE_TOKEN (Bearer token). In Claude Desktop, add an MCP server entry pointing to the command above.

Key Features

• Simple installation with both pip and uv.
• STDIO transport for easy embedding in desktop AI assistants.
• Automatic translation of MCP calls to Boost.Space REST requests.
• Minimal configuration – only API base URL and token are required.
• Works out of the box with Claude Desktop via MCP server settings.

Use Cases

• Integrating Boost.Space data (projects, files, metadata) into AI assistants that rely on MCP.
• Providing a local development sandbox where AI tools can experiment with Boost.Space APIs without handling HTTP details.
• Enabling third‑party MCP clients to extend Boost.Space functionality without writing custom API wrappers.

FAQ

Q: Do I need a special token? A: Yes, a Bearer token for Boost.Space is required and should be supplied via the BOOSTSPACE_TOKEN environment variable.

Q: Can I run the server behind a reverse proxy? A: The server communicates over STDIO, so it is typically launched directly by the client. For HTTP‑based transport you would need to wrap it yourself.

Q: Which transport protocols are supported? A: The default configuration uses stdio, which is compatible with Claude Desktop and similar MCP clients.

Q: How do I run tests or develop locally? A: Install development extras with pip install .[dev] and run pytest -q. Code style can be checked with ruff check ..

Boost.space MCP server

A Model Context Protocol (MCP) server proxying Boost.Space’s REST API for MCP clients (e.g., Claude Desktop).

Install

pip:

pip install boostspace-mcp

uv:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv add boostspace-mcp

Run

# pip
python -m boostspace_mcp.server

# uv
uv x boostspace-mcp run

Claude Desktop config

"mcpServers": {
  "boostspace": {
    "command": "python",
    "args": ["-m","boostspace_mcp.server"],
    "env": {
      "BOOSTSPACE_API_BASE": "{{API_PATH}}",
      "BOOSTSPACE_TOKEN": "{{TOKEN}}"
    },
    "transport": "stdio"
  }
}

Restart Claude Desktop.

Env vars

• BOOSTSPACE_API_BASE: API base URL
• BOOSTSPACE_TOKEN: Bearer token

Test & dev

pip install .[dev]
pytest -q
ruff check .