内容
# Upvote.club — MCP 应用
交互式 [MCP 应用](https://claude.com/docs/connectors/building/mcp-apps/getting-started) 带有内联 **任务进度卡**，用于 `获取任务状态`。
所有 6 个公共 API 工具均可用；`获取任务状态` 在 Claude 中呈现进度条 UI。
## 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 代码、手动 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 自定义连接器（可流式传输的 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-apps.git
cd upvote-club-mcp-apps
npm install
npm run build
UPVOTE_API_KEY=upv_... npm start
# → http://localhost:8788/mcp
```
标准输入（Claude 桌面版开发配置）：
```bash
UPVOTE_API_KEY=upv_... npm run start:stdio
```
```json
{
"mcpServers": {
"upvote-club-apps": {
"command": "node",
"args": ["/ABS/PATH/upvote-club-mcp-apps/main.js", "--stdio"],
"env": { "UPVOTE_API_KEY": "upv_..." }
}
}
}
```
## 使用隧道测试
通过 Cloudflare Tunnel 暴露 `http://localhost:8788/mcp`，并添加为 Claude.ai 自定义连接器，带有 `X-API-Key` 头。
## UI 设计
遵循 [MCP 应用设计指南](https://claude.com/docs/connectors/building/mcp-apps/design-guidelines)：内联卡、Claude 主题 CSS 变量、最多 2 个操作（刷新）。
## 工具（6 个）
`获取 API 参考`, `列出平台`, `创建任务`, `获取任务状态`, `删除任务`
完整参考：[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)
- 仅限 HTTP 的连接器，无 UI？ → [upvote-club-mcp-remote](https://github.com/upvoteclub/upvote-club-mcp-remote)
- Claude 桌面版捆绑包？ → [upvote-club-mcp-mcpb](https://github.com/upvoteclub/upvote-club-mcp-mcpb)
## 隐私
仅连接到 `https://api.upvote.club`。 https://upvote.club/privacy-policy
MCP 市场