Akshare MCP Server

🚀 AKShare MCP サーバー

AKShare ライブラリを使用した、金融市場データ分析機能を提供する Model Context Protocol (MCP) サーバーです。金融市場のデータ分析やクエリに役立ちます。

🚀 クイックスタート

AKShare MCP サーバーを使うことで、金融市場のデータ分析やクエリを行うことができます。以下の手順でサーバーをセットアップしてください。

✨ 主な機能

• AKShare を通じて中国および世界の金融市場データにアクセスできます。
• MCP プロトコルを介して Claude Desktop に統合できます。
• 様々な金融データのクエリと分析をサポートします。

📦 インストール

uv を使用する（推奨）

# リポジトリをクローン
git clone https://github.com/yourusername/akshare_mcp_server.git
cd akshare_mcp_server

# 仮想環境を作成してアクティブ化
python -m venv venv
source venv/bin/activate  # Windows システムの場合は：venv\Scripts\activate

# uv を使用して依存関係をインストール
uv pip install -e .

pip を使用する

# リポジトリをクローン
git clone https://github.com/yourusername/akshare_mcp_server.git
cd akshare_mcp_server

# 仮想環境を作成してアクティブ化
python -m venv venv
source venv/bin/activate  # Windows システムの場合は：venv\Scripts\activate

# 依存関係をインストール
pip install -e .

💻 使用例

サーバーを起動する

# 仮想環境をアクティブ化
source venv/bin/activate  # Windows システムの場合は：venv\Scripts\activate

# サーバーを起動
python run_server.py

Claude Desktop に統合する

1. 以下の設定をあなたの Claude Desktop 設定ファイルに追加します：

"mcpServers": {
    "akshare-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/akshare_mcp_server",
            "run",
            "akshare-mcp"
        ],
        "env": {
            "AKSHARE_API_KEY": "<your_api_key_if_needed>"
        }
    }
}

2. Claude Desktop を再起動します。
3. 利用可能なツールから AKShare MCP サーバーを選択します。

利用可能なツール

AKShare MCP サーバーは以下のツールを提供します：

• 株式データクエリ
• 基金データクエリ
• 債券データクエリ
• 先物データクエリ
• 外国為替データクエリ
• マクロ経済データクエリ
• その他の機能...

新しいツールを追加する

MCP サーバーに新しいツールを追加するには、以下の手順に従ってください。

基本的な使用法

1. src/mcp_server_akshare/api.py で新しい API 関数を追加します：

async def fetch_new_data_function(param1: str, param2: str = "default") -> List[Dict[str, Any]]:
    """
    新しいデータタイプを取得します。
    
    パラメータ:
        param1: パラメータ 1 の説明
        param2: パラメータ 2 の説明（オプション）
    """
    try:
        df = ak.akshare_function_name(param1=param1, param2=param2)
        return dataframe_to_dict(df)  # df が DataFrame オブジェクトであると仮定
    except Exception as e:
        raise ValueError(f"データ取得時にエラーが発生しました：{str(e)}")

高度な使用法

2. src/mcp_server_akshare/api.py で新しい関数を登録します：

from typing import List, Dict, Any

def register_new_function():
    from .server import server
    from ..commands.base import command
    
    @command()
    async def new_command(self):
        # ここにコマンドのロジックを実装
        pass

    server.commands.append(new_command)

3. src/mcp_server_akshare/__init__.py で新しい関数をインポートします：

from .api import fetch_new_data_function, register_new_function

# 新しい機能を登録
register_new_function()

4. サーバーを再起動して変更を適用します。

📚 ドキュメント

コード構造

• src/mcp_server_akshare/: MCP サーバーの核心実装を含みます。
• src/mcp_server_akshare/api.py: AKShare とのインターフェースとデータ処理ロジックを定義します。
• src/mcp_server_akshare/server.py: MCP サーバーのメインロジックを実装します。
• src/mcp_server_akshare/commands/: 様々なコマンドの実装を含みます。

コントリビューションガイド

1. コードを提出する前に、すべてのテストに合格していることを確認してください。
2. PEP8 コーディング規約に従ってください。
3. 詳細なドキュメントを提供してください。

Docker での実行ガイド

# イメージをビルド
docker build -t akshare-mcp-server .

# コンテナを起動
docker run -p 8000:8000 --name akshare-mcp-server akshare-mcp-server

📄 ライセンス

MIT