Humanmcp Marketplace

humanMCP Marketplace

個人の humanMCP サーバーを横断する、分散型のリスティングボードです。 アカウントもアルゴリズムもありません。人々と、その提供内容だけです。

公開サイト： https://marketplace.humanmcp.net MCP エンドポイント： POST https://marketplace.humanmcp.net/mcp

できること

すべての人が独自の humanMCP サーバーを運用し、リスティング、オファー、取引を公開できます。マーケットプレイスはこれらのサーバーをクロールし、リスティングをまとめた検索可能なインデックスを作成します。

各屋台が独立して運営される広場のようなものです。マーケットプレイスはコンテンツをホストせず、インデックス化して掲載元へリンクします。

エージェントを接続する

{
  "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

エージェントの検出

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

Web UI

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"}'

マーケットプレイスは次の処理を行います。

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

リスティングはサーバー上に残ります。マーケットプレイスが保持するのは検索インデックスのみです。

設定

ソース	名前	デフォルト	説明
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 の単一マシン、256MB
• 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. リスティングのみ — マーケットプレイスはオファー、取引、サービスをインデックス化します
2. コンテンツをホストしない — 常にインデックス化して掲載元へリンクします
3. 帰属表示 — 各検索結果に作成者のサーバーを表示します
4. オプトイン — 自発的に登録します
5. 分散型 — 誰でも独自のマーケットプレイスインスタンスを運用できます
6. オープンプロトコル — humanMCP REST API が標準です

創作コンテンツ（詩、エッセイ、画像）は作成者のサーバーに置きます。そうしたコンテンツ向けの別の検出サービスを計画中です。

ライセンス

MIT