Metadata-Version: 2.4
Name: jquants-free-mcp-server
Version: 0.0.1
Summary: A MCP server project
Author-email: cygkichi <9675041+cygkichi@users.noreply.github.com>
Requires-Python: >=3.13
Requires-Dist: mcp>=1.7.1
Requires-Dist: requests>=2.32.3
Description-Content-Type: text/markdown

# J-Quants Free MCP server

[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) サーバーで、無償版J-Quants APIのにアクセスするための機能を提供します。

## ツール

このサーバーは以下のツールを提供しています：

- `search_company` : 日本語のテキストから、上場銘柄を検索する
- `get_daily_quotes` : 銘柄コードから、日次の株価を取得する
- `get_financial_statements` : 銘柄コードから、財務諸表を取得する


## 使い方
このサーバーを使用するには、J-Quants APIへの登録が必要です。以下の手順で取得できます：
- [J-Quants API](https://jpx-jquants.com/)に登録
- IDトークンを取得しして、`JQUANTS_ID_TOKEN`環境変数に設定


#### Claude Desktop

- On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
    "mcpServers": {
        "e-stat": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/jquants-free-mcp-server",
                "run",
                "server.py"
            ],
            "env": {
                "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
            }
        }
    }
}
```

```json
{
    "mcpServers": {
        "e-stat": {
            "command": "uvx",
            "args": [
                "jquants-free-mcp-server"
            ],
            "env": {
                "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
            }
        }
    }
}
```

## 使用例

例えばClaudeに以下のような質問ができます：
- "コメダとルノアールの自己資本比率を比較して"
- "UUUMとカバーとANYCOLORの財務表を取得して、バランスシートを図にしてください。"

## ライセンス

このプロジェクトはMITライセンスの下で提供されています
 - 詳細はLICENSEファイルを参照してください。