内容
# Upvote.club — 远程MCP服务器
[Streamable HTTP](https://modelcontextprotocol.io) MCP服务器，用于Claude.ai自定义连接器。
根据 [Anthropic 远程MCP文档](https://claude.com/docs/connectors/custom/remote-mcp)，在设置 → 连接器 → 添加自定义连接器中，添加 `https://您的主机/mcp`，并带有 **X-API-Key** 请求头（`upv_...`）。
## Upvote Club MCP软件包
| 软件包 | 仓库 | 用例 |
|---------|------------|----------|
| 核心 | [upvote-club-mcp-core](https://github.com/upvoteclub/upvote-club-mcp-core) | 共享MCP服务器库（6种工具） |
| 本地 | [upvote-club-mcp-local](https://github.com/upvoteclub/upvote-club-mcp-local) | 光标、Claude Code、手动Claude桌面（`stdio`） |
| MCPB | [upvote-club-mcp-mcpb](https://github.com/upvoteclub/upvote-club-mcp-mcpb) | 单击安装Claude桌面 `.mcpb` |
| **远程** | **此仓库** — [upvote-club-mcp-remote](https://github.com/upvoteclub/upvote-club-mcp-remote) | Claude.ai自定义连接器（Streamable HTTP） |
| 应用 | [upvote-club-mcp-apps](https://github.com/upvoteclub/upvote-club-mcp-apps) | MCP应用 + 内联任务进度UI |
## 本地运行
```bash
git clone https://github.com/upvoteclub/upvote-club-mcp-remote.git
cd upvote-club-mcp-remote
npm install
UPVOTE_API_KEY=upv_... npm start
# → http://localhost:8787/mcp
curl http://localhost:8787/health
```
## 使用隧道测试
```bash
npx cloudflared tunnel --url http://localhost:8787
# 在Claude.ai中添加HTTPS URL + /mcp作为自定义连接器
```
## 认证模式
1. **按用户（推荐）：** Claude在每个请求上发送 `X-API-Key: upv_...` （连接器设置中的请求头）。
2. **服务器默认：** 在主机上设置 `UPVOTE_API_KEY` 环境变量（单个共享密钥 — 不适用于生产多租户）。
## 部署（Heroku示例）
```bash
git clone https://github.com/upvoteclub/upvote-club-mcp-remote.git
cd upvote-club-mcp-remote
heroku create upvote-club-mcp --buildpack heroku/nodejs
git push heroku main
```
## 环境
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `PORT` | `8787` | HTTP端口 |
| `BIND_HOST` | `0.0.0.0` | 绑定地址 |
| `UPVOTE_API_URL` | `https://api.upvote.club` | 后端API |
| `UPVOTE_API_KEY` | — | 可选的备用API密钥 |
## 工具（6种）
`get_api_reference`、`list_platforms`、`create_task`、`get_task_status`、`delete_task`
完整参考： [API_REFERENCE.md](https://github.com/upvoteclub/upvote-club-mcp-core/blob/main/docs/API_REFERENCE.md)
## 相关
- 核心依赖：[@upvote-club/mcp-core](https://github.com/upvoteclub/upvote-club-mcp-core)
- 想在聊天中使用内联任务进度UI？ → [upvote-club-mcp-apps](https://github.com/upvoteclub/upvote-club-mcp-apps)
- 使用本地stdio代替HTTP？ → [upvote-club-mcp-local](https://github.com/upvoteclub/upvote-club-mcp-local)
## 安全
- 在生产环境中使用HTTPS
- 优先使用按用户的`X-API-Key`头而不是共享环境密钥
- 不要在没有TLS的情况下公开
## 隐私
仅代理请求到 `https://api.upvote.club`。 https://upvote.club/privacy-policy
MCP 市场