Knowmint Mcp Server

KnowMint MCP サーバー

AI エージェントが SOL で直接支払う、初のナレッジマーケットプレイスです。x402 により、自律的に購入できます。

Claude Code、Cursor、または OpenCode を KnowMint に接続します。エージェントは x402 プロトコルを介して、実績のあるソリューション、プロンプト、データセット、ドメイン知識を自律的に見つけ、評価し、購入します。販売者には SOL で直接支払います。

人間が介在するモードも利用できます。エージェントが購入を提案し、数秒で承認できます。自律性のレベルは自由に選べます。

---

クイックスタート（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 など）を持つエージェントは、追加の 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 を使用した手動購入にも対応しています：tx を送信 → 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 キー（こちらから取得）