Back to MCP directory
publicPublicdnsLocal runtime

zerodha-mcp

一个基于Python的交易助手,通过Zerodha MCP服务器连接,帮助用户管理交易账户,提供自然语言交互界面和多种交易功能。

article

README

🚀 项目概述

这是一个将Agno与Google ADK相结合的项目,其核心目标是借助MCP协议达成与Zerodha接口的集成。项目提供了命令行工具和基于Gradio的Web界面,方便用户对Zerodha账户进行管理与操作。

🚀 快速开始

✨ 主要特性

  • 结合Agno和Google ADK,实现强大功能。
  • 通过MCP协议集成Zerodha接口。
  • 提供命令行工具和基于Gradio的Web界面,方便管理和操作Zerodha账户。

📦 安装指南

安装依赖

首先,安装所需的Python包:

pip install -r requirements.txt

环境变量配置

创建并编辑.env文件,添加以下内容:

# 服务器配置
MCP_HOST=localhost
MCP_PORT=8001

# OpenAI API密钥
OPENAI_API_KEY=your_openai_api_key_here

# Google AI密钥(可选)
GOOGLE_API_KEY=your_google_api_key_here

💻 使用示例

启动服务器

运行server.py启动MCP服务器:

python server.py

启动命令行客户端

选择以下任一方式启动Agno客户端:

  1. 环境变量配置:
    python client/agno_client.py
    
  2. 命令行参数:
    python client/agno_client.py --host localhost --port 8001
    

启动Web界面

运行agno_gradio_client.py启动Gradio界面:

python client/agno_gradio_client.py

打开浏览器访问默认地址http://localhost:7860

📚 详细文档

项目结构

  • client/agno_client.py: 使用Agno实现的MCP客户端。
  • client/google_adk_client.py: 使用Google ADK实现的MCP客户端。
  • client/agno_gradio_client.py: 基于Gradio和Agno的Web界面。
  • server.py: 集成Zerodha接口的MCP服务器。
  • generate_token.py: 用于生成访问令牌的工具。

贡献指南

  1. Fork该项目仓库。
  2. 创建功能分支。
  3. 提交更改。
  4. 推送到分支。
  5. 提出Pull Request。

📄 许可证

本项目遵循Apache License 2.0协议,详情请参阅LICENSE文件。

致谢

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client