@harurow/j-quants-doc-mcp

J-Quants APIのドキュメントを提供するMCPサーバー。Claude DesktopなどのMCPクライアントから、J-Quants APIのエンドポイント検索、詳細情報の取得、実装パターンの参照、FAQ回答などの機能を利用できます。

Note 本プロジェクトは J-Quants/j-quants-doc-mcp（(株)JPX総研による公式リポジトリ）を fork し、Python 実装を Node.js (TypeScript) に書き換えたものです。 元プロジェクトは MIT License で公開されており、本リポジトリもそのライセンスを継承しています。

必須要件

• Node.js 18以上

起動方法

npxで起動（推奨・インストール不要）

npx @harurow/j-quants-doc-mcp

インストールなしでそのまま実行できます。

グローバルインストールして起動

npm install -g @harurow/j-quants-doc-mcp

j-quants-doc-mcp

ローカルビルドで起動

git clone https://github.com/harurow/j-quants-doc-mcp.git
cd j-quants-doc-mcp
npm install
npm run build
node dist/index.js

Claude Desktopから使用

claude_desktop_config.jsonに以下を追加:

{
  "mcpServers": {
    "j-quants-doc-mcp": {
      "command": "npx",
      "args": ["-y", "@harurow/j-quants-doc-mcp"]
    }
  }
}

ローカルビルドを使用する場合:

{
  "mcpServers": {
    "j-quants-doc-mcp": {
      "command": "node",
      "args": ["/path/to/j-quants-doc-mcp/dist/index.js"]
    }
  }
}

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursorから使用

メニューバー「Cursor」→「Preferences」→「Cursor Settings」を開き、
左のメニュー「Tools & MCP」を選択し、「New MCP Server」をクリック。
開かれたJSONファイル(~/.cursor/mcp.json)に以下を追加:

{
  "mcpServers": {
    "j-quants-doc-mcp": {
      "command": "npx",
      "args": ["-y", "@harurow/j-quants-doc-mcp"]
    }
  }
}

以上の設定で、AIクライアントにてMCPサーバーを利用する準備が完了しました。

開発

# 依存関係のインストール
npm install

# ビルド
npm run build

# 開発用（tsx で直接実行）
npm run dev

# テスト
npm test

トラブルシューティング

Claude Desktopで認識されない

1. 設定ファイルのJSONが正しいか確認
2. Claude Desktopを再起動
3. npx @harurow/j-quants-doc-mcp をターミナルで直接実行してエラーがないか確認

環境変数

• JQUANTS_BASE_URL: APIドキュメントの取得元URLを上書きする場合に使用

クレジット

本プロジェクトは以下のリポジトリを fork して作成されています:

• 元リポジトリ: J-Quants/j-quants-doc-mcp
• 著作権者: JPX Market Innovation & Research, Inc.
• ライセンス: MIT License

関連リンク

• J-Quants API公式ドキュメント
• Model Context Protocol (MCP)
• Claude Desktop
• Cursor