Humanmcp

humanMCP

Model Context Protocol（MCP/JSON-RPC 2.0）に対応した、個人向けコンテンツサーバーです。

ライブサイト： https://kapoost.humanmcp.net ランディングページ： https://humanmcp.net マーケットプレイス： https://marketplace.humanmcp.net ネットワークエクスプローラー： https://humanmcp.net/humannetwork.html 作者： kapoost（Łukasz Kapuśniak）— 詩人、ものづくりをする人、船乗り。ワルシャワ／マルタ。

概要

humanMCPを使うと、誰でも著作権の暗号学的証明、明示的なライセンス条件、アクセスの完全な管理を備えたコンテンツやサービスを公開できます。作家、アーティスト、コンサルタント、職人、ギャラリー、フリーランサーなど、価値ある作品を生み出す人なら誰でも利用できます。AI エージェントはMCP経由で接続し、コンテンツをネイティブに利用できます。

誰でも自分専用のインスタンスを実行できます。1台のサーバー、1人の人間、その人自身のルールです。

MCP ツール（37以上）

コンテンツと検索

ツール	説明
get_author_profile	kapoostについて — 略歴、コンテンツの概要、閲覧方法
list_content	メタデータ付きですべての作品を閲覧し、種類やタグで絞り込みます
read_content	作品を読みます — すべてのアクセス制限が適用されます
search_content	すべての作品を対象に全文検索します
request_access	ロックされたコンテンツのアクセス条件を確認します
submit_answer	チャレンジ認証で制限されたコンテンツのロックを解除します
list_blobs	型付きデータアーティファクトを閲覧します
read_blob	画像、連絡先、データセット、ベクトルを読みます（対象者の制限が適用されます）

知的財産と検証

ツール	説明
verify_content	Ed25519署名を検証します
get_certificate	完全な知的財産証明書：ライセンス、価格、独自性インデックス、ハッシュ、署名
upgrade_timestamp	OTS証明をBitcoinに記録された証明にアップグレードします

インタラクション

ツール	説明
request_license	使用目的を申告して条件を取得します。監査用に記録されます
leave_comment	リアクションを残します — 作者のダッシュボードに表示されます
leave_message	直接メッセージを送信します（最大2000文字、URLも送信できます）
ask_human	作者に質問します（非公開、非同期 — question_idを返します）
get_answer	作者が質問に回答したか確認します（question_idを指定）

セッションとコンテキスト

ツール	説明
bootstrap_session	セッションコードでプライベートコンテキストのロックを解除します
recall	保存した記憶を取得します
remember	観察内容を保存します
query_vault	個人ナレッジベースを検索します
list_vault	ナレッジベースのドキュメントを一覧表示します

スキル

ツール	説明
list_skills / get_skill	エージェント向け指示カタログ
upsert_skill / delete_skill	スキルを管理します（エージェントトークン）

ペルソナ

ツール	説明
list_personas / get_persona	専門家チーム（セッションコードまたはVAULT_URLが必要です）
upsert_persona / delete_persona	ペルソナを管理します（エージェントトークン）

ペルソナとスキル：保存場所

humanmcp-go はフレームワークです。ペルソナのプロンプトとスキルの本文は、お客様が用意するものであり、このリポジトリには含まれていません。提供方法は次の 2 つです。

1. Owner API／マウントしたボリューム — EDIT_TOKEN を指定して upsert_persona／upsert_skill に POST するか、ホストボリュームの ${CONTENT_DIR}/personas/ と ${CONTENT_DIR}/skills/ に JSON ファイルを配置します。

2. 外部ボルト（推奨） — VAULT_URL 環境変数に、管理下のサーバー（例：tailnet 上のプライベートな FastAPI）を設定します。SkillStore は要求に応じて GET ${VAULT_URL}/persona/{id} と GET ${VAULT_URL}/skill/{slug} を取得し、メモリ内に 5 分間キャッシュします。これにより、機密性の高いプロンプトをお客様のマシンに保管したまま、公開フレームワークから提供できます。

ペルソナ JSON の形式（ボルトのレスポンス）：

{"id":"hermes","name":"Hermes","role":"Process Optimizer","prompt":"<full system prompt>"}

スキル JSON の形式（ボルトのレスポンス）：

{"slug":"system-diagram","title":"...","description":"...","persona_id":"mira","tags":[...],"instructions":"<full playbook>"}

VAULT_URL に接続できない場合、bootstrap_session はダウングレードを明確に報告します（通知なしにフォールバックすることはありません）。取得とキャッシュの実装については、internal/content/skill.go を参照してください。

掲載情報

ツール	説明
list_listings / read_listing	掲載された広告を閲覧します
respond_to_listing	掲載情報に返信します
subscribe_listings / unsubscribe_listings	Webhook サブスクリプションを管理します

フェデレーション

ツール	説明
list_peers	ネットワーク内の既知の humanMCP サーバーを一覧表示します
announce_peer	ネットワークに参加するため、サーバーを告知します

メタ

ツール	説明
about_humanmcp	オープンソースプロジェクトの情報を表示します

接続

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

コンテンツの種類

Pieces（Markdown ファイル）：

• 種類：poem、essay、note、artwork、image、contact
• アクセス権：public／members／locked
• ゲート：challenge（Q&A）、time、manual、trade
• ライセンス：free、cc-by、cc-by-nc、commercial、exclusive、all-rights
• 価格：自由形式の文字列（例：「500 PLN」、「$200」、「trade」）

Blobs（型付きデータ成果物）：

• 種類：image、contact、vector、document、dataset、capsule、provenance
• 対象者：[agent:claude, human:alice, agent:*]
• SIGNING_PRIVATE_KEY が設定されている場合、保存時に自動署名されます
• Provenance ドキュメントは artwork pieces（証明書、販売、意見、鑑定評価）にリンクします

エコシステム

• humanMCP Marketplace — すべての humanMCP サーバーを横断して検索できる、フェデレーション型検索サービスです。人々による掲載情報、オファー、取引を見つけられます。MCP エンドポイント · ソース
• humanNetwork — フォローしている humanMCP サーバーのコンテンツを時系列で表示する、ウォール形式のアグリゲーターです（stream.json を優先し、利用できない場合は MCP にフォールバックします）

連絡先

公開リンク：read_blob slug:"kapoost-contact" — 名前、ハンドル、github、instagram、facebook、ランディングページ。

非公開メールアドレス：read_content slug:"kapoost-contact-private" — アクセスには制限があります。アクセスするには、チャレンジに回答してください。

知的財産

すべての piece に Ed25519 署名が付与されます。get_certificate は次の情報を返します：

• SHA-256 コンテンツハッシュ
• Ed25519 署名と公開鍵
• Originality Index（0.0～1.0）：バースト性（Fano Factor）、語彙密度（CTTR）、シャノンエントロピー、構造シグネチャに基づく評価 — S/A/B/C/D のグレード
• ライセンス条件と価格（商用ライセンスの場合は sats）

検出と REST API

エージェントの検出：

• /.well-known/agent.json — エージェントのプロフィールカード
• /.well-known/mcp-server.json — MCP サーバーの検出
• /openapi.json — OpenAPI 3.1 仕様（ChatGPT、Gemini）
• /llms.txt — LLM の設定（署名付き）
• /for-agents — エージェント向けオンボーディングページ
• /connect — 接続方法のページ

REST API（MCP を使用しないエージェント向け）：

• GET /api/content — すべての piece を一覧表示します
• GET /api/content/{slug} — piece を読み取ります
• GET /api/search?q=... — 全文検索します
• GET /api/profile — 作者名、プロフィール、タグを取得します
• GET /api/blobs — データ成果物を一覧表示します
• GET /listings/feed.json — 掲載情報のフィード
• GET /content/stream.json — 統合コンテンツストリーム（pieces と掲載情報。humanNetwork 向け）

SEO：

• robots.txt、sitemap.xml、humans.txt

制限

項目	上限
メッセージ／コメントのテキスト	2000 文字
Blob のインラインテキスト	512 KB
ファイルのアップロード	50 MB
スラッグ	64 文字
タイトル	256 文字

機能

• i18n — メインページの PL／EN 言語切り替え（デフォルトは EN、localStorage に保存）
• ライセンスウィザード — 作品ごとの利用ルール：人間に許可されること、AI エージェントに許可されること
• 作品 — 写真のアップロード、媒体、寸法、制作年、来歴資料
• 来歴 — 証明書、販売記録、専門家の見解を作品に添付（署名付き）
• ask_human — エージェントが非公開で作者に質問できます（非同期の質疑応答、一般には非公開）
• フェデレーション — list_peers／announce_peer MCP ツールおよび /api/peers REST によるピアの検出
• 動的セクション — メインページには公開済みコンテンツがあるセクションのみ表示
• 自由形式の価格設定 — 任意の通貨、任意の形式（「500 PLN」、「$200」、「交換のみ」）

技術スタック

• Go 1.22、外部依存関係なし
• Fly.io（リージョン：waw）、永続ボリュームは /data
• Ed25519 署名（stdlib crypto）
• データベースとしてプレーンな Markdown ファイルを使用
• /new ページの8行のドラッグ＆ドロップ処理を除き、JavaScript なし

ワンクリックデプロイ

git clone https://github.com/kapoost/humanmcp-go.git
cd humanmcp-go
bash setup.sh

スクリプトで名前と自己紹介を入力すると、次の処理が行われます。

• Fly.io アプリを作成（無料枠）
• Ed25519 署名キーを生成
• シークレットを設定してデプロイ
• ログイントークンとワンクリックのフォローリンクを表示

約2分で完了します。次の URL が利用できます。

• https://yourname.humanmcp.net — あなたのサーバー
• https://yourname.humanmcp.net/connect — 友人との共有用
• https://humanmcp.net/humannetwork.html?add=https://yourname.humanmcp.net — ワンクリックでフォロー

ローカルで実行

go build ./cmd/server/
EDIT_TOKEN=secret AUTHOR_NAME=yourname ./server

手動デプロイ

fly launch --name yourname-humanmcp
fly secrets set EDIT_TOKEN=secret AUTHOR_NAME=yourname
fly deploy

署名キー（任意ですが推奨）

go run ./cmd/keygen/
fly secrets set SIGNING_PRIVATE_KEY="..." SIGNING_PUBLIC_KEY="..."

今後の予定

• Blob ファイルへの C2PA マニフェスト埋め込み（CA の信頼チェーンが個人にも開放された場合）
• 商用ライセンス向けの Lightning Network 支払いゲート
• スコア付きの対話型ゲート（エージェントが API キーを提示し、Claude が回答を評価）
• スパム対策の IP レート制限とエンゲージメントトークン

テスト

コンテンツ、MCP、アップロード／署名／ライセンスの各テストスイートにわたる136件のテスト。

go test ./...