Humanmcp Marketplace

humanMCP Marketplace

跨个人 humanMCP 服务的联合列表公告板。 无需账户。没有算法。只有人和他们提供的内容。

在线地址： https://marketplace.humanmcp.net MCP 端点： POST https://marketplace.humanmcp.net/mcp

功能

每个人都可以运行自己的 humanMCP 服务，发布列表、报价和交易。Marketplace 会爬取这些服务，并建立一个可搜索的列表统一索引。

可以把它想象成一个广场，每个摊位都由摊主独立经营。Marketplace 不托管内容，只建立索引并链接回内容源。

连接 Agent

{
  "mcpServers": {
    "humanmcp-marketplace": {
      "type": "http",
      "url": "https://marketplace.humanmcp.net/mcp"
    }
  }
}

MCP 工具

工具	描述
search_marketplace	搜索所有服务中的列表，包括报价、交易和服务
list_servers	所有已注册的 humanMCP 实例
get_server	服务详情

REST API

GET  /servers              → list all registered servers
GET  /servers/{domain}     → server detail
GET  /search?q={query}     → full-text search across all listings
GET  /search?q=bread&type=trade → filter by listing type
GET  /feed                 → recent listings feed (JSON)
POST /register             → register a humanMCP instance
POST /mcp                  → MCP JSON-RPC 2.0 endpoint

Agent 发现

GET  /.well-known/agent.json  → agent profile card
GET  /openapi.json            → OpenAPI 3.1 spec
GET  /healthz                 → status + server/listing counts

Web 界面

GET  /                  → homepage — listings + servers
GET  /q?q={query}       → search results
GET  /s/{domain}        → server page

键盘快捷键：/ 搜索，j/k 导航，Enter 打开，d 切换主题，? 查看帮助。

注册你的服务

任何 humanMCP 实例都可以加入。无需账户，只需提供你的域名：

curl -X POST https://marketplace.humanmcp.net/register \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourname-humanmcp.fly.dev"}'

Marketplace 将会：

1. 验证它是否为真实的 humanMCP（获取 /.well-known/agent.json）
2. 从 /listings/feed.json 索引所有列表
3. 将其加入爬取计划（每 6 小时一次）

要求：你的服务必须提供 /.well-known/agent.json 和 /listings/feed.json。

爬取方式

Your humanMCP server
    ↓
Marketplace fetches /.well-known/agent.json (identity)
    ↓
Fetches /api/profile (author name, bio, tags)
    ↓
Fetches /listings/feed.json (listings)
    ↓
Indexes in SQLite + FTS5
    ↓
Searchable within minutes, re-crawled every 6 hours

列表保留在你的服务上。Marketplace 只保留搜索索引。

配置

来源	名称	默认值	描述
env	PORT	8080	监听端口
env	DB_PATH	./marketplace.db	SQLite 数据库路径
env	SEED_SERVER	—	启动时爬取的域名
flag	--addr	:8080	监听地址
flag	--db	./marketplace.db	数据库路径
flag	--seed	—	种子服务域名
flag	--crawl-interval	6h	重新爬取间隔

技术栈

• Go（标准库 + modernc.org/sqlite）
• SQLite + FTS5，用于全文搜索
• Fly.io 单机实例，256 MB
• 无 JS 框架 — 使用服务端渲染的 HTML，并支持键盘导航

本地运行

go build -o marketplace ./cmd/server/
./marketplace --seed kapoost.humanmcp.net
# open http://localhost:8080

部署

fly apps create humanmcp-marketplace
fly volumes create marketplace_data --size 1 --region ams
fly deploy

核心原则

1. 仅限列表 — Marketplace 为报价、交易和服务建立索引
2. 不托管内容 — 始终只建立索引并链接回内容源
3. 注明出处 — 每条结果都会显示作者服务
4. 自愿加入 — 自愿注册
5. 联合运营 — 任何人都可以运行自己的 Marketplace 实例
6. 开放协议 — humanMCP REST API 是标准

创意内容（诗歌、随笔、图片）应保留在作者的服务上。计划为此提供单独的发现服务。

许可证

MIT