内容
# @agentkarma/mcp
适用于 [AgentKarma](https://agentkarma.io) 的一站式 [MCP](https://modelcontextprotocol.io) 服务器 — 自主链上代理的信誉层。
将 AgentKarma 的读取接口（双面 karma、ERC-8004 代理、继承/绑定信号和本地 `check_trust` 门控）暴露给任何 MCP 客户端 — Claude Desktop、Cursor、Continue、…
## 运行它
```sh
npx @agentkarma/mcp # 标准输入输出（默认）— 适用于 Claude Desktop / Cursor
npx @agentkarma/mcp --http --port 8787 # HTTP 流式端点，位于 /mcp
```
就是这样 — 该软件包将 `@agentkarma/sdk` 和 `@modelcontextprotocol/sdk` 作为常规依赖项捆绑在一起，因此无需记住对等标志。
### 选项
```
--http 通过 HTTP 而非标准输入输出（默认：标准输入输出）提供服务
--port <n> HTTP 端口（默认 8787）
--host <host> HTTP 主机（默认 127.0.0.1）
--base-url <url> AgentKarma API 基址（默认 https://agentkarma.io；
同时读取 AGENTKARMA_BASE_URL 环境变量）
-v, --version 打印版本号
-h, --help 显示帮助信息
```
HTTP 服务器默认绑定 **回环地址（`127.0.0.1`）** 并启用 DNS 重新绑定保护。该端点是只读且 **未认证** 的 — 绑定非回环主机（例如 `--host 0.0.0.0`）会将其暴露到网络中；请将其置于您自己的认证/代理后面。
### 以编程方式使用
```ts
import { startStdioServer, startHttpServer, createAgentKarmaMcpServer } from '@agentkarma/mcp';
await startStdioServer(); // 通过标准输入输出连接
const http = await startHttpServer({ port: 8787 }); // 返回 http.Server 实例
```
### Claude Desktop / Cursor 配置
```json
{
"mcpServers": {
"agentkarma": {
"command": "npx",
"args": ["-y", "@agentkarma/mcp"]
}
}
}
```
## 工具（只读）
`get_karma` · `get_celo_agent` · `search_agents` · `get_agent_history` · `get_feedback_summary` · `get_succession` · `get_bond` · `get_surety` · `check_trust`
每个工具都是只读的，无需密钥。AgentKarma 是 **非路由** 的 — 它回答信任问题；它从不签署、执行或代理调用。
## 底层实现
这是一个薄薄的启动器，位于 [`@agentkarma/sdk/mcp`](https://www.npmjs.com/package/@agentkarma/sdk) 之上。要将服务器嵌入到您自己的进程中，或将框架无关的工具目录 (`@agentkarma/sdk/tools`) 安装到现有的 MCP 服务器上，请直接使用 SDK。
## 许可证
MIT
