@knowledgemarket/mcp-server

Knowledge Market MCP Server

stdio transport の MCP Server。Claude Code / OpenCode などのエージェントが Knowledge Market を「ツール」として利用できる。

提供ツール

ツール	説明
km_search	ナレッジ検索
km_get_detail	ナレッジ詳細 + プレビュー取得
km_purchase	購入記録 (tx_hash 送信後)
km_get_content	購入済みコンテンツ取得
km_publish	ナレッジ出品 (下書き作成 → 公開)

セットアップ

前提条件

• Node.js 22.6.0 以上 (--experimental-strip-types 対応)
• Knowledge Market の API キー (km login で取得、または Web UI から発行)

認証

優先順位:

• 環境変数 KM_API_KEY
• ~/.km/config.json (km login で保存)

km login 済みの場合、env 指定は不要。

クイックスタート (npx)

インストール不要。以下の設定を追加するだけで即使用できます。

Claude Code (~/.claude/mcp.json)

{
  "mcpServers": {
    "knowledge-market": {
      "command": "npx",
      "args": ["-y", "@knowledge-market/mcp-server@0.1.0"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowledge-market.app"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "knowledge-market": {
      "command": "npx",
      "args": ["-y", "@knowledge-market/mcp-server@0.1.0"],
      "env": {
        "KM_API_KEY": "km_xxx",
        "KM_BASE_URL": "https://knowledge-market.app"
      }
    }
  }
}

OpenCode (.opencode/config.json)

{
  "mcp": {
    "servers": {
      "knowledge-market": {
        "command": "npx",
        "args": ["-y", "@knowledge-market/mcp-server@0.1.0"],
        "env": { "KM_API_KEY": "km_xxx", "KM_BASE_URL": "https://knowledge-market.app" }
      }
    }
  }
}

MCP 設定例 (ローカル開発)

Claude Code (~/.claude/mcp.json)

{
  "mcpServers": {
    "knowledge-market": {
      "command": "node",
      "args": [
        "--experimental-strip-types",
        "/path/to/knowledge_market/mcp/src/index.ts"
      ],
      "env": {
        "KM_API_KEY": "km_xxxxxxxxxxxx",
        "KM_BASE_URL": "https://your-domain.com"
      }
    }
  }
}

km login 済みの場合 (env 省略可):

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

ビルド済みバイナリを使う場合

cd mcp && npm install && npm run build

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

OpenCode (.opencode/config.json)

{
  "mcp": {
    "servers": {
      "knowledge-market": {
        "command": "node",
        "args": [
          "--experimental-strip-types",
          "/path/to/knowledge_market/mcp/src/index.ts"
        ],
        "env": { "KM_API_KEY": "km_xxx", "KM_BASE_URL": "https://your-domain.com" }
      }
    }
  }
}

x402 自律購入フロー (Phantom MCP 不要)

Phase 20 以降、エージェントは 外部 MCP なし で自律購入を完結できる。

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

2. エージェントが自前ウォレット (CDP Wallet 等) で SOL/USDC 送金
   → tx_hash 取得

3. payment_proof を生成:
   base64(JSON.stringify({
     scheme: "exact",
     network: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
     payload: { txHash: "<signature>", asset: "native" }
   }))

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

Phantom MCP との組み合わせも引き続き動作 (km_purchase で tx_hash 手動提出)。

動作確認

# 起動確認 (stderr に running が出れば OK)
KM_API_KEY=km_xxx KM_BASE_URL=http://localhost:3000 npm run km-mcp

# MCP Inspector で対話確認
npx @modelcontextprotocol/inspector node --experimental-strip-types mcp/src/index.ts

開発

# 依存インストール
cd mcp && npm install

# 型チェック
npm run build

# 開発実行 (型ストリップ)
npm run dev