@harurow/j-quants-doc-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@harurow/j-quants-doc-mcp Find the J-Quants endpoint for stock prices."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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.jsClaude 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.jsonWindows:
%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で認識されない
設定ファイルのJSONが正しいか確認
Claude Desktopを再起動
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 toolsdescribe_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Search and manage your team's knowledge from MCP clients.
Read, search, and compare SEC EDGAR filings, pull tables, and run AI analysis from any MCP client.
Make your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
AlicenseAqualityDmaintenanceEnables searching J-Quants API endpoints, retrieving detailed documentation, generating executable sample code, and answering FAQs via MCP clients like Claude Desktop.716MIT- AlicenseAqualityDmaintenanceMCP server exposing portfolio AI tools including semantic search, evaluation framework, and prompt management, enabling natural language interaction with these services via Claude Desktop.5ISC
- AlicenseAqualityDmaintenanceMCP 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.5MIT
- AlicenseBqualityDmaintenanceEnables AI-driven semantic code search via natural language queries, integrating with MCP clients like Claude Desktop to retrieve relevant code context from any codebase.1MIT