黑123 Hackathons MCP · hack123-mcp

中文 | English

黑123（hack123.henryht.sh）黑客松导航站的远程 MCP 服务和只读 REST API 源码。 Source of the remote MCP server and read-only REST API behind 黑123, a bilingual hackathon directory.

• MCP 端点 / endpoint：https://hack123.henryht.sh/api/mcp（Streamable HTTP，只读，免费，无需 API Key / read-only, free, no API key）

• REST API：https://hack123.henryht.sh/api/v1/hackathons

• 官方 MCP Registry：io.github.onehumanbeing/hack123

• 文档 / docs：https://hack123.henryht.sh/about#mcp

中文

这是什么

让 AI 助手（Claude、Cursor、Cherry Studio、VS Code 等）直接查询黑123 收录的国内外黑客松、组队帖和往届作品。每条结果都带黑123 站内链接，站内详情页再链接到主办方官网。

不依赖 MCP SDK：手写最小 JSON-RPC 2.0，无状态、无鉴权，部署在 Vercel Serverless Functions 上。

工具

完整参数以 tools/list 返回为准。

接入

支持远程 MCP 的客户端：

{
  "mcpServers": {
    "hack123": {
      "type": "streamable-http",
      "url": "https://hack123.henryht.sh/api/mcp"
    }
  }
}

只支持本地 stdio 的客户端，可以用 mcp-remote 转一下：

{
  "mcpServers": {
    "hack123": { "command": "npx", "args": ["-y", "mcp-remote", "https://hack123.henryht.sh/api/mcp"] }
  }
}

命令行自测：

curl -s -X POST https://hack123.henryht.sh/api/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

可以这样问：「这周还能报名的线上 AI 黑客松有哪些？」「上海 12 月有什么黑客松？」「有没有面向学生、奖金 10 万以上的比赛？」

REST API

GET https://hack123.henryht.sh/api/v1/hackathons，只读、可跨域、CDN 缓存 10 分钟。常用参数：

curl 'https://hack123.henryht.sh/api/v1/hackathons?q=上海&status=open'
curl 'https://hack123.henryht.sh/api/v1/hackathons?topic=ai&mode=online&sort=prize&page=2'

数据来源

本仓库只有查询代码，不含数据。数据来自黑123 站点构建时生成的公开文件（https://hack123.henryht.sh/mcp-data.json、https://hack123.henryht.sh/data/api-hackathons.json），由黑123 每天对照主办方官网整理更新；比赛信息以主办方官网为准。

自己部署

npm test          # Node 20+
npx vercel deploy # 部署后 /api/mcp 和 /api/v1/hackathons 即可用，数据仍从黑123 公开文件读取

Related MCP server: yan

English

What it is

Lets AI assistants query hackathons (China and worldwide), team-up posts and past projects listed on 黑123. Every result links to its hack123.henryht.sh page, which links to the organizer's official page.

No MCP SDK: a minimal hand-written JSON-RPC 2.0 handler, stateless and unauthenticated, running as Vercel Serverless Functions.

Tools

See tools/list for the exact schemas.

Connect

{
  "mcpServers": {
    "hack123": { "type": "streamable-http", "url": "https://hack123.henryht.sh/api/mcp" }
  }
}

For stdio-only clients: npx -y mcp-remote https://hack123.henryht.sh/api/mcp.

REST API

GET https://hack123.henryht.sh/api/v1/hackathons — read-only, CORS enabled, 10-minute CDN cache. Parameters: q, lang, status, mode, region, city, topic, sort, page, limit, slug (see the table above).

Data

This repo contains query code only, no data. Data comes from public files generated when hack123.henryht.sh is built (/mcp-data.json, /data/api-hackathons.json), curated daily against organizers' official pages. Always confirm details on the organizer's site.

License

MIT