Skip to main content
Glama
@harurow/j-quants-doc-mcp

@harurow/j-quants-doc-mcp

by Harurow

@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以上

Related MCP server: toad-mcp-server

起動方法

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

関連リンク

Available Tools

7 tools
describe_endpointB

指定されたエンドポイントの詳細情報を取得する。

Inputs: endpoint_name (required), api_version.

fetch_spec_pageA

指定されたパスのSpecificationページを取得する。エンドポイント詳細だけでなく、参照データページ(例: 休日区分、市場コード等)も取得できます。Markdown内のリンクを辿って追加情報を取得する際に使用してください。

Inputs: path (required).

get_infoA

API仕様書の範囲外の質問に回答するためのツール。プランの種類・料金・価格、契約方法・申込方法・支払い方法、各プランで利用可能なデータ範囲・期間、アカウント・ログインに関する問い合わせ、サポート・お問い合わせ先などの質問を受けた場合に使用してください。

Inputs: query.

get_patternA

実装パターン情報を取得する。パターン名を指定しない場合は全パターンの一覧を返す。

Inputs: pattern_name.

health_checkA

ヘルスチェック用の簡易Tool。サーバが正常に動作しているかを確認する。

Inputs: no named parameters.

migrate_v1_to_v2A

V1 APIからV2 APIへの移行ガイドを提供する。V1 APIを利用中のユーザーがV2 APIへ移行する際に、エンドポイントの対応関係や変更点を案内し、V2の仕様書ページへ誘導します。

Inputs: v1_endpoint.

search_endpointsA

エンドポイントをキーワードとカテゴリで検索する。

Inputs: keyword (required), category, api_version.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but describe_endpoint and fetch_spec_page overlap in retrieving endpoint information. The descriptions clarify the difference (structured details vs. raw specification pages), so ambiguity is limited to this pair.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun_pattern using snake_case (e.g., get_pattern, search_endpoints, fetch_spec_page). The exception health_check is a standard compound noun but does not disrupt the overall consistency.

    Tool Count5/5

    With 7 tools, the server is well-scoped for its documentation purpose. Each tool covers a distinct function (health, patterns, search, details, raw pages, migration, general info) without redundancy or excessive specialization.

    Completeness4/5

    The toolset provides comprehensive coverage for exploring and using J-Quants API documentation: search, detail, raw specs, patterns, migration, and general questions. A minor gap is the lack of an explicit 'list all endpoints' function, but search_endpoints may handle this implicitly.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server exposing portfolio AI tools including semantic search, evaluation framework, and prompt management, enabling natural language interaction with these services via Claude Desktop.
      5
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      MCP server to fetch Japanese financial laws and regulations from the e-Gov API, preventing hallucinations in Claude's responses. Supports 9 domains including Financial Instruments and Exchange Act, Banking Act, etc.
      5
      MIT