返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端