The Band MCP Server provides a comprehensive Model Context Protocol interface for the Band social platform, enabling AI assistants and MCP-compatible tools to interact with Band data through full read/write operations.
Core Capabilities:
User & Band Management: Get user profiles, list bands, and verify permissions within specific bands
Post Management: Retrieve, create, and delete posts with pagination and detailed information access
Comment Management: Fetch, add, and remove comments with appropriate permission checks
Media Access: Browse photo albums and photos within Band groups
Secure Authentication: Band API access token integration with comprehensive error handling
Robust Integration: Input validation using Zod schemas, API rate limit handling, and MCP resource/tool exposure
Flexible Deployment: Docker container, npm install, npx execution, or local development options
Enables packaging and deploying the MCP server as a Docker container for simplified deployment and portability.
Handles environment variables for configuring sensitive information like API credentials.
Enables version control and cloning of the repository for installation.
Provides the runtime environment for the MCP server, requiring Node.js 18+ for operation.
Manages dependencies and provides scripts for building, testing, and running the server.
Implements the server using TypeScript for type safety and maintainability.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Band MCP Servershow me the latest posts from my band group"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
As a standalone executable: Installed via
npmand configured directly in a compatible MCP client.As a Docker container: Pulled from Docker Hub and configured in a compatible MCP client to be run on-demand.
Related MCP server: Teams Messenger MCP App
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.
In Claude Desktop, open Settings > Developer and click Edit Config.
Add the following to the
mcpServersobject inclaude_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.
In Claude Desktop, open Settings > Developer and click Edit Config.
Add the following to the
mcpServersobject inclaude_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.