A fully functional Model Context Protocol (MCP) server that integrates with the Band API. This server enables seamless interaction with the Band social platform through AI assistants and other MCP-compatible tools.

Overview

This server can be used in two primary ways:

1. As a standalone executable: Installed via npm and configured directly in a compatible MCP client.
2. As a Docker container: Pulled from Docker Hub and configured in a compatible MCP client to be run on-demand.

Usage & Client Configuration

To use this server, you need a Band API Access Token. You can obtain one from the Band Developer Portal.

Below are configuration examples for different clients and usage methods.

Example 1: Claude Desktop (NPM version)

This method assumes you have installed the server via npm install -g band-mcp-server.

1. In Claude Desktop, open Settings > Developer and click Edit Config.
2. Add the following to the mcpServers object in claude_desktop_config.json:

{
  "mcpServers": {
    "band-api": {
      "command": "band-mcp-server",
      "args": [],
      "env": {
        "BAND_ACCESS_TOKEN": "your_band_api_access_token"
      }
    }
  }
}

Replace your_band_api_access_token with your actual token.

Example 2: Claude Desktop (Docker version)

This method uses the Docker image and does not require npm.

1. In Claude Desktop, open Settings > Developer and click Edit Config.
2. Add the following to the mcpServers object in claude_desktop_config.json:

{
  "mcpServers": {
    "band-api-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BAND_ACCESS_TOKEN=your_band_api_access_token",
        "kanghouchao/band-mcp-server:latest"
      ]
    }
  }
}

Replace your_band_api_access_token with your actual token.

License

This project is licensed under the MIT License.