MCP Zhitou Server

🚀 MCP プロトコルと智兔数服 API の統合ガイド

本プロジェクトは、MCP（Multi - Modal Protocol）プロトコルを通じて、AI アシスタントと智兔数服が提供する滬深株式データサービスをシームレスに接続することを目的としています。この統合方案により、AI はリアルタイムの株式データや市場情報を直接呼び出すことができ、投資分析や意思決定に強力なサポートを提供します。

🚀 クイックスタート

1. MCP サービスの初期化

プロジェクトのメインファイルで、MCP エージェントインスタンスを初期化します。

from mcp import Agent

# MCP エージェントインスタンスを作成
agent = Agent(
    name="TradingAssistant",
    description="A comprehensive trading assistant integrating with MCP protocol.",
    tools=TOOLS.values()
)

2. 利用可能なツールの定義

mcp_z兔_server.py ファイルで利用可能なツールを定義します。

# ツールリスト
TOOLS = {
    "get_stock_list": get_stock_list,
    "get_new_stock_calendar": get_new_stock_calendar,
    "get_company_profile": get_company_profile,
    "get_capital_daily_trend": get_capital_daily_trend,
    "get_all_announcements": get_all_announcements
}

3. サービスの起動

MCP エージェントサービスを起動します。

if __name__ == "__main__":
    agent.run()

✨ 主な機能

• MCP（Multi - Modal Protocol）プロトコルを使用して、AI アシスタントと智兔数服の滬深株式データサービスをシームレスに接続します。
• AI がリアルタイムの株式データや市場情報を直接呼び出すことができ、投資分析や意思決定に役立ちます。

📦 インストール

1. 環境要件

• Python バージョン: Python 3.6 以上。
• MCP プロトコルライブラリ: AI エージェントとの通信を実現するために mcp - client ライブラリをインストールする必要があります。

2. インストール手順

# MCP クライアントライブラリをインストール
pip install mcp - client

# 本プロジェクトのリポジトリをクローン
git clone https://github.com/your - username/mcp - trading.git
cd mcp - trading

💻 使用例

基本的な使用法

上記の「クイックスタート」の手順に従って、MCP サービスを初期化、ツールを定義、サービスを起動することで、基本的な使用が可能です。

高度な使用法

新しいツールを追加することで、より高度な機能を実現できます。具体的には以下の手順で行います。

1. 智兔 API ドキュメントを参照して、必要な機能の API エンドポイントを見つけます。智兔数服 API ドキュメント
2. mcp_z兔_server.py で新しい Python 関数を開発して、目標の API を呼び出します。パラメータと戻り値を適切に処理し、明確なコメントを追加します。
3. 新しいツールを TOOLS 辞書に登録します。

# 新しいツールの例
def new_tool_function(params):
    # 実装ロジック
    pass

TOOLS["new_tool"] = new_tool_function

📚 ドキュメント

ツールリスト

現在実装されているツールは以下の通りです。

設定ガイド

1. MCP クライアント設定

設定ファイル config.json を作成します。

{
    "mcp": {
        "host": "localhost",
        "port": 5000,
        "timeout": 30
    },
    "api_key": "your_api_key_here"
}

エラー処理

1. 一般的なエラー

• API 呼び出し失敗: ネットワーク接続と API キーの有効性を確認してください。
• ツールが登録されていない: すべてのツールが TOOLS 辞書に正しく追加されていることを確認してください。

📄 ライセンス

本プロジェクトは MIT ライセンスに従います。詳細は LICENSE ファイルを参照してください。

貢献ガイド

ご貢献いただけることを歓迎します！参加方法については CONTRIBUTING.md を参照してください。

上記の手順に従えば、MCP プロトコルと智兔数服 API を簡単に統合し、AI プロジェクトに強力な金融データ処理能力を追加することができます。