REMOTE MCP SERVERS JACK

远程MCP服务器

一组可部署到Google Cloud Run的MCP（模型上下文协议）服务器，可供任何兼容MCP的客户端（Claude、ChatGPT等）使用。

当前服务器

Spotify MCP服务器

直播： https://spotify-mcp-421545226088.us-central1.run.app/mcp

Spotify的播放控制、搜索、队列管理、库访问和设备控制。

文档

📖 MCP服务器开发指南 -综合指南涵盖：

• 项目结构和配置
• FastMCP设置（无状态_http，json_response）
• 身份验证模式（OAuth、API密钥）
• API客户端模式
• 云运行部署
• 秘密管理
• 测试策略
• 常见陷阱和解决方案

Spotify MCP服务器

特性

• 播放控制：播放、暂停、跳过、音量、洗牌、重复
• 搜索：查找曲目、专辑、艺术家、播放列表
• 队列管理：查看并添加到队列
• 图书馆：查看最近播放的播放列表，如曲目
• 设备控制：列出设备，传输播放

快速开始

1.设置Spotify应用程序

1. 首选https://developer.spotify.com/dashboard
2. 创建新应用程序
3. 注意你的 客户端ID 和 客户端密钥
4. 添加重定向URI: http://127.0.0.1:8888/callback （使用127.0.0.1，而不是本地主机）

2.获取刷新令牌

# Set credentials
export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret"

# Run OAuth flow
python scripts/get_spotify_token.py

3.地方发展

# Create venv
python -m venv .venv
source .venv/bin/activate

# Install
uv pip install -e ".[dev]"

# Set env vars (or use .env file)
export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret"
export SPOTIFY_REFRESH_TOKEN="your_refresh_token"

# Run (stdio mode for local clients like Claude Desktop)
python -m spotify_mcp.server

# Run (HTTP mode for testing)
MCP_TRANSPORT=http PORT=8080 python -m spotify_mcp.server

4.部署到云端运行

# First time: Create secrets in Google Secret Manager
echo -n "your_client_id" | gcloud secrets create SPOTIFY_CLIENT_ID --data-file=-
echo -n "your_client_secret" | gcloud secrets create SPOTIFY_CLIENT_SECRET --data-file=-
echo -n "your_refresh_token" | gcloud secrets create SPOTIFY_REFRESH_TOKEN --data-file=-

# Deploy
gcloud run deploy spotify-mcp \
    --source . \
    --region us-central1 \
    --allow-unauthenticated \
    --set-secrets="SPOTIFY_CLIENT_ID=SPOTIFY_CLIENT_ID:latest,SPOTIFY_CLIENT_SECRET=SPOTIFY_CLIENT_SECRET:latest,SPOTIFY_REFRESH_TOKEN=SPOTIFY_REFRESH_TOKEN:latest" \
    --memory 512Mi \
    --timeout 300

5.测试部署

# Initialize connection
curl -X POST https://YOUR-SERVICE-URL/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}, "id": 1}'

# List tools
curl -X POST https://YOUR-SERVICE-URL/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

# Call a tool
curl -X POST https://YOUR-SERVICE-URL/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "spotify_get_playback", "arguments": {}}, "id": 3}'

6.连接MCP客户端

对于基于HTTP的MCP客户端（如远程聊天机器人）：

{
  "mcpServers": {
    "spotify": {
      "transport": "streamable-http",
      "url": "https://spotify-mcp-421545226088.us-central1.run.app/mcp"
    }
  }
}

对于基于stdio的MCP客户端（如Claude Desktop）：

{
  "mcpServers": {
    "spotify": {
      "command": "python",
      "args": ["-m", "spotify_mcp.server"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret",
        "SPOTIFY_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

可用工具

建筑

运输方式

配置

服务器使用 FastMCP 使用以下云部署设置：

mcp = FastMCP(
    "spotify",
    stateless_http=True,   # No session state (scalable)
    json_response=True,    # JSON responses (not SSE streams)
)

项目结构

├── pyproject.toml
├── Dockerfile
├── .env.example
├── docs/
│   └── MCP_SERVER_GUIDE.md    # Development & deployment guide
├── scripts/
│   └── get_spotify_token.py
└── src/spotify_mcp/
    ├── __init__.py
    ├── server.py              # FastMCP tools
    ├── auth.py                # OAuth token management
    └── client.py              # Spotify API wrapper

许可证

麻省理工学院