经纪工具服务器

通过模型上下文协议(MCP)暴露经纪和市场工具(Angel One, Coinbase, 新闻)的FastMCP服务器。

  • by deepjyotk
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 deepjyotk/broker-buddy-mcp-server

使用说明

经纪人好友MCP服务器

FastMCP服务器通过模型上下文协议(MCP)公开经纪和市场工具(Angel One、Coinbase、News)。

工具

  • 天使一号:
    • get_portfolio_holdings
    • execute_delivery_trade
  • Coinbase:
    • get_portfolio
  • 外部:
    • scrape_stock_news_summaries
  • 系统:
    • tool:health

快速设置

  1. 先决条件:Python 3.13+和 uv.
  2. 安装:
git clone <repository-url>
cd broker-buddy-mcp-server
make setup
  1. 运行:
make run
# or
uv run broker-buddy-mcp

违约: http://127.0.0.1:9000/mcp/.

必需的标题

  • x-user-id:唯一用户id
  • x-scopes:逗号分隔的范围(例如。, portfolio:read,portfolio:trade)

.env示例

创建一个 .env 在repo根目录中。看 src/configs/angel_one_secrets.py 对于完整的字段文档。

# ---- Angel One (required) ----
ANGELONE_HISTORY_API_KEY=...
ANGELONE_HISTORY_SECRET_KEY=...
ANGELONE_TRADING_API_KEY=...
ANGELONE_TRADING_SECRET_KEY=...
ANGELONE_TOTP_SECRET=...
ANGELONE_CLIENT_CODE=...
ANGELONE_PIN=...
# Optional (for eDIS flows)
# ANGELONE_DP_ID=
# ANGELONE_BO_ID=

# ---- Coinbase (if using Coinbase tools) ----
COINBASE_API_KEY=...
COINBASE_API_SECRET=...

# ---- Server (optional) ----
FASTMCP_HOST=127.0.0.1
FASTMCP_PORT=9000
FASTMCP_PATH=/mcp/

# Hide tools by tags (optional, comma-separated). Leave empty to show all.
EXCLUDE_TOOLS_TAGS=

光标配置(可选)

增添 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "broker-buddy-mcp": {
      "transport": "http",
      "url": "http://127.0.0.1:9000/mcp/",
      "headers": {
        "x-user-id": "sample-user-123",
        "x-scopes": "portfolio:read,portfolio:trade"
      }
    }
  }
}

备注

  • 保持你的 .env 私人;永远不要泄露秘密。
  • 范围控制访问;设置最低要求的范围。