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 Agent 通过 MCP 连接，并以原生方式与您的内容交互。

每个人都可以运行自己的实例。一个服务，一个人，由自己定规则。

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	Agent 指令目录
upsert_skill / delete_skill	管理技能（需要 Agent 令牌）

角色

工具	描述
list_personas / get_persona	您的专家团队（需要会话代码或 VAULT_URL）
upsert_persona / delete_persona	管理角色（需要 Agent 令牌）

人设与技能：存放位置

humanmcp-go 是一个框架。人设提示词和技能正文由你提供，不包含在此仓库中。可通过两种方式提供：

1. 所有者 API / 挂载卷 — 使用 EDIT_TOKEN 调用 upsert_persona / upsert_skill，或将 JSON 文件放入主机卷上的 ${CONTENT_DIR}/personas/ 和 ${CONTENT_DIR}/skills/。

2. 外部保险库（推荐） — 将 VAULT_URL 环境变量设置为你控制的服务（例如，运行在 tailnet 上的私有 FastAPI）。SkillStore 会按需从 GET ${VAULT_URL}/persona/{id} 和 GET ${VAULT_URL}/skill/{slug} 获取内容，并使用 5min 的内存缓存。这样，敏感提示词可以留在你的机器上，同时由公开框架提供服务。

人设 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"
    }
  }
}

内容类型

作品（Markdown 文件）：

• 类型：poem、essay、note、artwork、image、contact
• 访问权限：public / members / locked
• 门控方式：challenge（问答）、time、manual、trade
• 许可：free、cc-by、cc-by-nc、commercial、exclusive、all-rights
• 价格：自由格式字符串（例如 "500 PLN"、"$200"、"trade"）

数据块（类型化数据制品）：

• 类型：image、contact、vector、document、dataset、capsule、provenance
• 受众：[agent:claude, human:alice, agent:*]
• 如果设置了 SIGNING_PRIVATE_KEY，保存时会自动签名
• 来源证明文档会关联到艺术作品（证书、销售、意见、估价）

生态系统

• humanMCP Marketplace — 跨所有 humanMCP 服务进行联邦搜索。查找人类发布的广告、报价和交易。MCP 端点 · 源代码
• humanNetwork — 墙式聚合器，按时间顺序展示你关注的 humanMCP 服务内容（优先使用 stream.json，MCP 作为回退）

联系方式

公开链接：read_blob slug:"kapoost-contact" — 姓名、账号、github、instagram、facebook、落地页。

私人邮箱：read_content slug:"kapoost-contact-private" — 访问受限。回答挑战问题即可访问。

知识产权

每件作品都使用 Ed25519 签名。get_certificate 返回：

• SHA-256 内容哈希
• Ed25519 签名 + 公钥
• 原创性指数（0.0–1.0）：突发性（Fano 因子）、词汇密度（CTTR）、Shannon 熵、结构特征 — 评级为 S/A/B/C/D
• 许可条款和以 sats 计价的价格（适用于商业许可）

发现与 REST API

Agent 发现：

• /.well-known/agent.json — Agent 资料卡
• /.well-known/mcp-server.json — MCP 服务发现
• /openapi.json — OpenAPI 3.1 规范（ChatGPT、Gemini）
• /llms.txt — LLM 偏好设置（已签名）
• /for-agents — Agent 入门页面
• /connect — 连接方式页面

REST API（供不使用 MCP 的 Agent 使用）：

• GET /api/content — 列出所有作品
• GET /api/content/{slug} — 读取作品
• GET /api/search?q=... — 全文搜索
• GET /api/profile — 作者姓名、简介、标签
• GET /api/blobs — 列出数据制品
• GET /listings/feed.json — 广告订阅源
• GET /content/stream.json — 统一内容流（作品 + 广告，供 humanNetwork 使用）

SEO：

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

限制

字段	限制
消息 / 评论文本	2000 个字符
Blob 内联文本	512 KB
文件上传	50 MB
Slug	64 个字符
标题	256 个字符

功能

• 国际化 — 主页面支持 PL/EN 语言切换（默认 EN，存储在 localStorage 中）
• 许可向导 — 为每件作品设置使用规则：人类可以做什么，AI Agent 可以做什么
• 艺术作品 — 上传照片、填写媒介、尺寸、年份和来源证明文件
• 来源证明 — 为艺术作品附加证书、销售记录和专家意见（已签名）
• ask_human — Agent 可以私下向作者提问（异步问答，不对公众显示）
• 联合 — 通过 list_peers / announce_peer MCP 工具和 /api/peers REST 发现对等节点
• 动态版块 — 主页面仅显示包含已发布内容的版块
• 自由定价 — 支持任意货币和格式（“500 PLN”、“$200”、“仅限以物易物”）

技术栈

• Go 1.22，无外部依赖
• Fly.io（区域：waw），/data 下的持久化卷
• Ed25519 签名（标准库 crypto）
• 使用纯 Markdown 文件作为数据库
• 除 /new 页面上 8 行代码实现的拖放功能外，不使用 JS

一键部署

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

脚本会询问你的姓名和简介，然后：

• 创建一个 Fly.io 应用（免费套餐）
• 生成 Ed25519 签名密钥
• 设置密钥并部署
• 输出你的登录令牌和一键关注链接

约 2 分钟即可完成。你将获得：

• 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 支付门槛
• 评分式对话门槛（Agent 提供 API 密钥，由 Claude 评估回答）
• IP 速率限制和互动令牌，用于防止垃圾信息

测试

136 项测试，覆盖内容、MCP，以及上传 / 签名 / 许可测试套件。

go test ./...