UU

upvoteclub/upvote-club-mcp-remote

Developer tools
42 stars 0 forks Качество 35 Тренд 35

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

  1. Per-user (recommended): Claude sends X-API-Key: upv_... on every request (Request headers in connector settings).
  2. Server default: Set UPVOTE_API_KEY env 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

Security

  • Use HTTPS in production
  • Prefer per-user X-API-Key headers over a shared env key
  • Do not expose without TLS

Privacy

Proxies requests to https://api.upvote.club only. https://upvote.club/privacy-policy

View this README on GitHub

Установка

npx cloudflared tunnel --url http://localhost:8787