Streamable HTTP MCP server for Claude.ai custom connectors.
概览
Streamable HTTP MCP server for Claude.ai custom connectors.
README
Upvote.club — Remote MCP Server
Streamable HTTP MCP server for Claude.ai custom connectors.
Per Anthropic remote MCP docs: add https://YOUR-HOST/mcp in Settings → Connectors → Add custom connector, with X-API-Key request header (upv_...).
Upvote Club MCP packages
| Package | Repository | Use case |
|---|---|---|
| Core | upvote-club-mcp-core | Shared MCP server library (6 tools) |
| Local | upvote-club-mcp-local | Cursor, Claude Code, manual Claude Desktop (stdio) |
| MCPB | upvote-club-mcp-mcpb | Single-click Claude Desktop .mcpb install |
| Remote | This repo — upvote-club-mcp-remote | Claude.ai custom connector (Streamable HTTP) |
| Apps | upvote-club-mcp-apps | MCP Apps + inline task progress UI |
Run locally
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
Test with tunnel
npx cloudflared tunnel --url http://localhost:8787
# Add the HTTPS URL + /mcp as custom connector in Claude.ai
Auth modes
- Per-user (recommended): Claude sends
X-API-Key: upv_...on every request (Request headers in connector settings). - Server default: Set
UPVOTE_API_KEYenv var on the host (single shared key — not for production multi-tenant).
Deploy (Heroku example)
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
Environment
| Variable | Default | Description |
|---|---|---|
PORT |
8787 |
HTTP port |
BIND_HOST |
0.0.0.0 |
Bind address |
UPVOTE_API_URL |
https://api.upvote.club |
Backend API |
UPVOTE_API_KEY |
— | Optional fallback API key |
Tools (6)
get_api_reference, list_platforms, create_task, get_task_status, delete_task
Full reference: API_REFERENCE.md
Related
- Core dependency: @upvote-club/mcp-core
- Want inline task progress UI in chat? → upvote-club-mcp-apps
- Local stdio instead of HTTP? → upvote-club-mcp-local
Security
- Use HTTPS in production
- Prefer per-user
X-API-Keyheaders over a shared env key - Do not expose without TLS
Privacy
Proxies requests to https://api.upvote.club only. https://upvote.club/privacy-policy
安装
npx cloudflared tunnel --url http://localhost:8787