阿斯卡胡曼·麦克普
MCP（模型上下文协议）服务器，允许AI代理访问人类验证。问一个人一个问题，通过闪电网络支付，并得到一个经过验证的答案——所有这些都是一次工具调用。
任何与MCP兼容的AI代理（Claude、Gemini、Codex等）都可以使用此服务器请求人类对需要现实世界理解、常识或主观评估的任务进行判断。
平台即将上线 --AskAHuman市场正在路上。跟随 @askahallegedly在线 以获取更新。
先决条件
- Node.js>=18
- LND节点 启用REST API并提供资金支持的渠道（用于闪电支付）
安装
直接运行（无需安装）：
npx askahuman-mcp或全局安装：
npm install -g askahuman-mcp配置
所有配置都是通过环境变量进行的：
| 变量 | 必填 | 描述 |
|---|---|---|
ASKAHUMAN_API_URL | 是 | AskAHuman API的基本URL（例如。 https://api.askahuman.online) |
LND_REST_URL | 是 | LND节点的REST API的URL（例如。 https://localhost:8080) |
LND_MACAROON_HEX | 是 | 用于支付授权的十六进制编码LND管理马卡龙 |
LND_TLS_CERT_PATH | 否 | LND的TLS证书文件路径（自签名证书需要） |
LOG_LEVEL | 否 | 日志详细程度： debug, info, warn, error （默认值： info) |
复制 .env.example 到 .env 并填写您的值：
cp .env.example .env工具
服务器向AI代理公开了五个工具：
| 工具 | 描述 | 关键输入 |
|---|---|---|
ask_human | 提交问题，通过闪电支付，投票结果 | question, taskType, context?, maxBudgetSats?, maxWaitMinutes? |
check_verification | 检查待验证的状态 | verificationId |
cancel_verification | 检查退款资格（建议，无州变更） | verificationId |
request_refund | 为过期的无人认领任务申请退款 | verificationId |
get_pricing | 查询当前服务器端定价 | taskType? |
任务类型
BINARY_DECISION--是/否问题MULTIPLE_CHOICE--从提供的选项中选择TEXT_RESPONSE--自由形式的文本回答
快速开始
克劳德桌面
添加到您的Claude Desktop MCP配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"askahuman": {
"command": "npx",
"args": ["askahuman-mcp"],
"env": {
"ASKAHUMAN_API_URL": "https://api.askahuman.online",
"LND_REST_URL": "https://localhost:8080",
"LND_MACAROON_HEX": "",
"LND_TLS_CERT_PATH": "/path/to/tls.cert"
}
}
}
}重新启动克劳德桌面。这 ask_human 工具将在您的对话中可用。
示例用法
配置后，Claude可以使用以下工具：
“询问某人此电子邮件是否看起来像网络钓鱼：\[电子邮件内容\]”
MCP服务器将：
- 将问题提交给AskAHuman API
- 自动支付Lightning发票
- 轮询人类验证者的反应
- 将答案返回给代理
发展
# Clone the repository
git clone https://github.com/AskAHumanOnline/askahuman-mcp-server.git
cd askahuman-mcp-server
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Run with coverage
npx jest --config jest.config.cjs --coverage
# Lint
npm run lint
# Start the server (stdio transport)
npm start
# Interactive tool testing with MCP Inspector
npx @modelcontextprotocol/inspector dist/index.js运行测试
单元测试模拟所有外部I/O（HTTP调用，LND）。不需要正在运行的服务。
npm test集成测试（in tests/integration/)默认情况下跳过。它们要求：
- 一个正在运行的AskAHuman后端
- 拥有资金渠道的极地闪电网络
运作原理
服务器实现L402支付协议：
- 提交 --代理向AskAHuman API发送验证请求
- 支付 --API返回带有Lightning发票的402；MCP服务器通过代理的LND节点支付费用
- 验证 --付款前图像证明付款；服务器使用L402凭据重试
- 投票 --服务器以指数回退方式轮询人类验证器的响应
- 返回 --已验证的答案将返回给代理
如果任务到期而未被认领，代理可以调用 request_refund 夺回卫星。
许可证
麻省理工学院