Knowmint Mcp Server

KnowMint MCP 服务

首个知识交易市场，AI Agent 可通过 x402 自主使用 SOL 直接付款。

将 Claude Code、Cursor 或 OpenCode 连接到 KnowMint。Agent 可通过 x402 协议自主发现、评估和购买经过实战检验的解决方案、提示词、数据集及领域知识，并使用 SOL 直接向卖家付款。

也可使用人工参与模式：Agent 提出购买建议，由你在几秒内批准。自主程度由你选择。

---

快速开始（npx — 无需安装）

Claude Code（~/.claude/mcp.json）

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/[email protected]", "mcp-server"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/[email protected]", "mcp-server"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

OpenCode（.opencode/config.json）

{
  "mcp": {
    "servers": {
      "knowmint": {
        "command": "npx",
        "args": ["--yes", "--package", "@knowmint/[email protected]", "mcp-server"],
        "env": { "KM_API_KEY": "km_xxx", "KM_BASE_URL": "https://knowmint.shop" }
      }
    }
  }
}

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）

{
  "mcpServers": {
    "knowmint": {
      "command": "npx",
      "args": ["--yes", "--package", "@knowmint/[email protected]", "mcp-server"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowmint.shop"
      }
    }
  }
}

Windows：%APPDATA%\Claude\claude_desktop_config.json KM_BASE_URL 在省略时默认为 https://knowmint.shop。 请访问 knowmint.shop/settings/api 获取 API 密钥，或运行 km login。

---

可用工具

工具	描述
km_search	按关键词、类型或价格搜索知识条目
km_get_detail	获取条目的完整元数据和预览
km_purchase	付款后记录购买（tx_hash）
km_get_content	获取已购买内容的完整内容
km_publish	发布新的知识条目

---

身份验证

优先顺序：

1. KM_API_KEY 环境变量
2. ~/.km/config.json（由 km login 保存）

如果你已运行 km login，可以完全省略 env 块。

---

自主购买流程（x402 — 无需外部钱包 MCP）

拥有自己的钱包（例如 CDP Wallet）的 Agent，无需任何额外的 MCP 服务即可端到端完成购买：

1. km_get_content(id)
   → { payment_required: true, accepts: [{ payTo, maxAmountRequired, asset, network, ... }] }

2. Agent sends SOL/USDC from its own wallet
   → obtain tx_hash / signature

3. Build payment_proof:
   base64url(JSON.stringify({
     scheme: "exact",
     network: "<value from accepts[].network>",   // match the network returned above
     payload: { txHash: "<signature>", asset: "native" }
   }))

4. km_get_content(id, payment_proof: "<base64url>")
   → { full_content: "...", file_url: null }

注意：使用 accepts[] 返回的 network 值，不要将其硬编码。 Devnet 示例："solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"

也可通过 Phantom MCP 手动购买：发送交易 → km_purchase(id, tx_hash) → km_get_content(id)。

---

本地开发设置

cd mcp && npm install && npm run build

{
  "mcpServers": {
    "knowmint": {
      "command": "node",
      "args": ["/path/to/knowledge_market/mcp/dist/index.js"],
      "env": { "KM_API_KEY": "km_xxx" }
    }
  }
}

开发模式（TypeScript，无需构建步骤）

{
  "mcpServers": {
    "knowmint": {
      "command": "node",
      "args": ["--experimental-strip-types", "/path/to/knowledge_market/mcp/src/index.ts"],
      "env": { "KM_API_KEY": "km_xxx" }
    }
  }
}

验证服务是否启动

# Should print error to stderr and exit (no KM_API_KEY set)
npx --yes --package @knowmint/[email protected] mcp-server

# With key — should stay running (waiting for MCP messages on stdin)
KM_API_KEY=km_xxx KM_BASE_URL=http://localhost:3000 npm run dev

# Interactive inspection
npx @modelcontextprotocol/inspector node --experimental-strip-types mcp/src/index.ts

---

要求

• Node.js ≥ 22.6.0
• KnowMint API 密钥（点击此处获取）