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 協議，實現 AI 助手與智兔數服滬深股票數據服務的無縫對接。
• 支持 AI 直接調用即時股票數據和市場信息，為投資分析和決策提供強大支持。

📦 安裝指南

1. 環境要求

• Python 版本：Python 3.6 或更高版本。
• MCP 協議庫：需要安裝 mcp-client 庫以實現與 AI 代理的通信。

2. 安裝步驟

# 安裝 MCP 客戶端庫
pip install mcp-client

# 克隆本項目倉庫
git clone https://github.com/your-username/mcp-trading.git
cd mcp-trading

💻 使用示例

基礎用法

在項目主文件中初始化 MCP 代理實例並啟動服務，示例代碼如下：

from mcp import Agent

# 創建 MCP 代理實例
agent = Agent(
    name="TradingAssistant",
    description="A comprehensive trading assistant integrating with MCP protocol.",
    tools=TOOLS.values()
)

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

高級用法

可根據需求在 mcp_z兔_server.py 文件中定義新的工具函數，並將其註冊到 TOOLS 字典中，示例代碼如下：

# 新工具示例
def new_tool_function(params):
    # 實現邏輯
    pass

TOOLS["new_tool"] = new_tool_function

📚 詳細文檔

工具列表

當前已實現的工具如下：

擴展指南

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 項目增添強大的金融數據處理能力。