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 
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 私人；永远不要泄露秘密。
• 范围控制访问；设置最低要求的范围。