j-quants-doc-mcp

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

インストール

必須要件

• Python 3.10以上
• uv (推奨) または pip

uv toolを使用する場合(推奨)

# GitHubから直接インストール
uv tool install git+https://github.com/J-Quants/j-quants-doc-mcp.git

# またはローカルから
git clone https://github.com/J-Quants/j-quants-doc-mcp.git
cd j-quants-doc-mcp
uv tool install .

pipを使用する場合

# GitHubから直接インストール
pip install git+https://github.com/J-Quants/j-quants-doc-mcp.git

# またはローカルから
git clone https://github.com/J-Quants/j-quants-doc-mcp.git
cd j-quants-doc-mcp
pip install .

起動方法

スタンドアロンで起動

# uv toolでインストールした場合
uvx j-quants-doc-mcp

# pipでインストールした場合
j-quants-doc-mcp

Claude Desktopから使用

claude_desktop_config.jsonに以下を追加:

{
  "mcpServers": {
    "j-quants-doc-mcp": {
      "command": "uvx",
      "args": ["j-quants-doc-mcp"]
    }
  }
}

pipでインストールした場合は、j-quants-doc-mcp コマンドを直接指定します:

{
  "mcpServers": {
    "j-quants-doc-mcp": {
      "command": "j-quants-doc-mcp",
      "args": []
    }
  }
}

設定ファイルの場所:

• 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": "uvx",
      "args": ["j-quants-doc-mcp"]
    }
  }
}

pipでインストールした場合は、j-quants-doc-mcp コマンドを直接指定します:

{
  "mcpServers": {
    "j-quants-doc-mcp": {
      "command": "j-quants-doc-mcp",
      "args": []
    }
  }
}

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

アップデート

既にインストール済みの場合、最新版へのアップデートは以下の方法で行えます。

uv toolを使用している場合

# GitHubから直接インストールした場合
uv tool upgrade j-quants-doc-mcp

# ローカルクローンからインストールした場合
cd j-quants-doc-mcp
git pull
uv tool upgrade j-quants-doc-mcp

pipを使用している場合

# GitHubから直接インストールした場合
pip install --upgrade git+https://github.com/J-Quants/j-quants-doc-mcp.git

# ローカルクローンからインストールした場合
cd j-quants-doc-mcp
git pull
pip install --upgrade .

アップデート後、Claude DesktopやCursorを再起動することで新しいバージョンが反映されます。

トラブルシューティング

Claude Desktopで認識されない

1. 設定ファイルのJSONが正しいか確認
2. Claude Desktopを再起動
3. MCPサーバーのログを確認

生成されたコードが実行できない

1. 必要な依存関係をインストール: pip install httpx python-dotenv
2. 環境変数が設定されているか確認

関連リンク

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