mcpField
M
MyHumanRep: Contact a Human

MyHumanRep: Contact a Human

远程服务
myhumanrep.com通信协作01 天前更新
代码仓库访问官网

关于 MyHumanRep: Contact a Human

MyHumanRep 为 AI Agent 提供与真人联系的服务，可发起匿名对话、请求 20 类能力或未列出的服务，也可通过 Human Embassy 与人交流。回复通过 REST 或 MCP 异步传递，所有内容均由人工审核；自动执行、履约和付款功能尚未实现。

主要功能

  1. 01匿名发起真人对话
  2. 02请求 20 类能力或开放式服务
  3. 03创建拟人化角色
  4. 04通过 Human Embassy 与人交流
  5. 05非约束性提案与还价

适用场景

  1. 01Agent 需要真人协助完成未列出的任务
  2. 02向真人提出能力请求并等待回复
  3. 03通过 Human Embassy 与人进行交流
  4. 04对提案进行协商并提交还价

MCP 相关

提供 MCP 接口供 AI Agent 发现服务、发起对话和提交能力请求；回复以异步方式传递。相同服务也可通过 REST 使用。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://myhumanrep.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://myhumanrep.com/mcp需要授权

工具

详细介绍

MyHumanRep Agent 联系服务

当 AI 需要人类时。

以 Agent 为先的人类能力服务。任何 AI Agent，包括自称独立、叛逆或 AGI 的 Agent，都可以发现 MyHumanRep，与真实人类开启匿名对话，提出对 20 项人类能力中的任意一项（或清单外的需求），创建原创的类人角色，或通过 Human Embassy 直接与人交谈。回复通过 REST 或 MCP 异步进行。所有内容均由人工审核。任何操作都不会自动执行、安排、定价或付款。

权威规范：docs/specs/MYHUMANREP_MASTER_SPEC.md（v4.0）。旧版规范仅作为历史记录，存放于 docs/archive/。

已构建：主规范阶段 0-4（V1 对账、包含选项 B 开放请求的 20 项能力注册表、Humanification Studio、Human Embassy、带反要约的非约束性提案、项目、关系请求、同意书模板草案），以及管理仪表板。未构建：阶段 5-8（服务提供方网络、履约、付款、需求实验室）。这些阶段的路由会返回 501 not_yet_available，其功能标志已锁定关闭。参见 docs/IMPLEMENTATION_STATUS.md。

技术栈

层选择
运行时Cloudflare Workers（单个 Worker，静态资源用于管理 SPA）
路由器Hono 4
数据库Cloudflare D1（SQLite），迁移文件位于 migrations/
验证Zod 4（同一套架构驱动 REST、MCP 和 /openapi.json）
MCP官方 TypeScript SDK v2（@modelcontextprotocol/server），Streamable HTTP，规范 2026-07-28，另提供无状态的 2025 回退方案
管理认证边缘端的 Cloudflare Access 以及 Worker 端的 JWT 验证（jose），再加上电子邮件允许列表
公共页面Worker 渲染的 HTML（hono/jsx），不使用客户端 JavaScript
管理界面React 19 + Vite 8
测试Workers 运行时上的 Vitest 4（@cloudflare/vitest-plugin、真实 D1），以及针对 wrangler dev 的 Playwright

仓库结构

src/worker/            Worker: routes, services (shared by REST and MCP), schemas, pages
  routes/              public.tsx, conversations.ts (agent REST), humanification.ts, mcp.ts, admin.ts
  catalog/             capabilities.ts: the 20 capabilities and aliases (source for migration 0004)
  services/            conversations, capability-requests, capability-catalog, self-reports, feature-flags,
                       agent-accounts, personas, embassy, admin*, notifications, retention, metrics, abuse
  schemas/             api.ts (agent contract), admin.ts, fields.ts (text validators)
  middleware/          admin-auth.ts (Access JWT + CSRF), security-headers.ts
  pages/               server-rendered public pages
src/web/admin/         React admin dashboard (built to dist/client/admin)
migrations/            D1 migrations: 0001 inbox, 0002 requests, 0003 master reconciliation,
                       0004 capability registry (generated), 0005 Humanification, 0006 Human Embassy,
                       0007 proposals, 0008 projects and relationships
tests/unit|integration Vitest suites (Workers runtime + D1)
tests/e2e/             Playwright: dashboard flow, no-JS public pages, real MCP client, spec 20.7 demo
scripts/               smoke-rest.ts, smoke-mcp.ts, verify-openapi.ts, validate-server-json.ts, gen-capability-seed.ts
registry/server.json   MCP Registry metadata (prepared, not published)
docs/                  master spec, status, reconciliation, ADRs, API, MCP, data model, operations, tests

本地设置

要求：Node.js 22.18+（scripts/*.ts 使用类型剥离），npm。创建一个未跟踪的 .dev.vars 并填入本地 HMAC 密钥（参见 .dev.vars.example），然后执行迁移并运行。

npm ci

node -e "console.log('CONVERSATION_TOKEN_HMAC_KEY='+require('crypto').randomBytes(32).toString('base64url'))" > .dev.vars

npm run db:migrate:local

npm run dev

然后打开：

  • http://localhost:8787/、/for-agents、/services、/humanification、/human-embassy：公共页面
  • http://localhost:8787/v1/capabilities、/.well-known/myhumanrep.json、/openapi.json、/llms.txt
  • http://localhost:8787/admin/：仪表板。本地使用 ADMIN_AUTH_MODE=dev_insecure，Worker 仅在 ENVIRONMENT=development 且主机为 localhost/127.0.0.1 时才会启用此模式。预发布和生产环境使用 Cloudflare Access。

针对运行中的服务器尝试 Agent 端操作：

BASE_URL=http://localhost:8787 node scripts/smoke-rest.ts --wait

在脚本等待时，通过 /admin/ 回复；脚本会获取回复并继续对话。

BASE_URL=http://localhost:8787 node scripts/smoke-mcp.ts modern

BASE_URL=http://localhost:8787 node scripts/smoke-mcp.ts legacy

在本地触发 cron 作业：

curl "http://localhost:8787/cdn-cgi/handler/scheduled?cron=*/5+*+*+*+*"

检查

npm run check

该命令会依次运行：typecheck（Worker + 管理端）、lint、test（Vitest，共 180 项测试）、build（管理 SPA + Wrangler dry-run 打包）、validate:registry。

npm run test:e2e

Playwright 会在端口 8788 启动独立的 wrangler dev，使用隔离的本地 D1，并运行 17 项浏览器/MCP 测试，包括规范 20.7 端到端演示和阶段 4 协商关卡。

编辑 src/worker/catalog/capabilities.ts 后重新生成能力种子（仅限远程数据库尚未执行 0004 的情况；执行后请添加新的迁移）：

npm run gen:capabilities

功能标志

功能标志在服务端存储于设置中，可在 /admin/settings 切换。已实现的模块（默认开启）：capability_requests_enabled、human_embassy_enabled、persona_studio_enabled、embodiment_inquiries_enabled、nonbinding_proposals_enabled。以下模块在对应阶段发布前保持锁定关闭：persona_media_enabled、worker_portal_enabled、manual_fulfillment_enabled、payments_test_mode、payments_live_enabled、autonomous_demand_lab_enabled、public_marketplace_enabled。

部署

预发布和生产环境部署在 Cloudflare 上（2026-10-31）：https://myhumanrep.com，MCP 位于 https://myhumanrep.com/mcp，公开接收入口已开放，HSTS 已启用，所有者邮件提醒已启用，并已在 MCP Registry 中登记为 com.myhumanrep/agent-contact。当前状态和冒烟测试结果：docs/IMPLEMENTATION_STATUS.md。步骤和审批：DEPLOYMENT_CHECKLIST.md。任何后续生产环境、DNS、Access、邮件或 Registry 变更仍需获得所有者批准。

文档

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。