Ziwei Ai

ZiweiAI MCP Server

中文说明见 README.zh-CN.md。

ZiweiAI のレポート向け MCP（Model Context Protocol）サーバーです。Cursor、Claude Desktop、その他の MCP クライアントで利用すると、レポートの一覧表示、整えられたレポート内容の取得、支払いリンクの取得ができます。

リポジトリ： https://github.com/Timmy9527/agentziwei

インストール

オプション A – 公開済みの npm パッケージを使用（推奨）：

npm install ziweiai-mcp-server

または、インストールせずに直接実行します（Node.js ≥18 が必要です）。

npx ziweiai-mcp-server

オプション B – ソースからビルド（リポジトリをクローン）：

cd mcp-server
npm install
npm run build

前提条件

1. MCP API キー：ziweiai.com または ziweiai.com.cn にログインし、My Reports に移動して、MCP Integration を見つけ、Generate MCP API Key をクリックします。キーをコピーします（キーが表示されるのは一度だけです）。
2. レポート：先にウェブサイトでレポートを購入してください。MCP で一覧表示や内容の取得ができるのは、購入済みのレポートのみです。

環境変数

変数	必須	説明
ZIWEIAI_MCP_API_KEY	はい	ウェブサイトで取得した MCP API キーです。
ZIWEIAI_API_BASE	いいえ	API のベース URL（デフォルト：https://ziweiai.com）。アカウントまたはレポートが中国版サイトにある場合は、https://ziweiai.com.cn を使用してください。

実行

npm でインストールした場合：

export ZIWEIAI_MCP_API_KEY="your-key-here"
npx ziweiai-mcp-server

または、グローバル bin を使用します（npm install -g ziweiai-mcp-server の実行後）。

export ZIWEIAI_MCP_API_KEY="your-key-here"
ziweiai-mcp

ソースからビルドした場合：

export ZIWEIAI_MCP_API_KEY="your-key-here"
node dist/index.js

または、tsx を使用します（ビルド不要）：ZIWEIAI_MCP_API_KEY="your-key" npx tsx src/index.ts

Cursor の設定

Cursor の MCP 設定に追加します（例：~/.cursor/mcp.json または Cursor Settings → Features → MCP）。

npm パッケージを使用する場合（推奨）：

{
  "mcpServers": {
    "ziweiai": {
      "command": "npx",
      "args": ["-y", "ziweiai-mcp-server"],
      "env": {
        "ZIWEIAI_MCP_API_KEY": "your-mcp-api-key"
      }
    }
  }
}

-y を指定すると、npx は確認を求めずにパッケージを使用します。your-mcp-api-key を実際のキーに置き換えてください。

ローカルビルドを使用する場合（先にリポジトリをクローン）：

{
  "mcpServers": {
    "ziweiai": {
      "command": "node",
      "args": ["/path/to/ziweiai/mcp-server/dist/index.js"],
      "env": {
        "ZIWEIAI_MCP_API_KEY": "your-mcp-api-key"
      }
    }
  }
}

/path/to/ziweiai を実際のパスに置き換えてください。

ツール

• list_my_reports – 購入済みレポートの一覧を表示します（利用者向け一覧）。
• list_report_types – レポートタイプのコードを一覧表示します（ming、ln、lc、ll、lr、cp、dh）。
• get_report_content – 整えられたレポート内容を取得します（生成パラメーターと language を渡します）。
• get_payment_link – ウェブサイトでレポートを購入するための URL を取得します（クエリパラメーター：paper）。

レポート一覧 API（GET/POST /api/mcp/reports）

• 認証：MCP API キーを含む X-MCP-API-Key ヘッダー。
• クエリパラメーター（任意）：format=human（人が読みやすいフィールドを返します）、lang=zh または lang=en（format=human の場合、デフォルトは en）。format を指定しない場合、API は未加工の配列を返します。
• format=human の場合、各項目には reportType、queryInfo、reportPath が含まれます（ウェブサイトの「My reports」ページと同じ意味です）。未加工データの binddate は連結された文字列です。無効な値や空の値は安全に処理され、エラーは発生しません。

お支払い

支払いは常にウェブサイトで行います。MCP では、購入済みレポートの一覧表示と整えられた内容の返却、および未購入のレポートタイプの支払いリンクの提供のみを行います。