使用说明

项目简介

Angle One MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它集成了 Angle One 金融 API，旨在为大型语言模型 (LLM) 应用提供访问金融市场数据和执行交易操作的标准接口。通过此服务器，LLM 应用可以便捷地获取实时的市场信息、管理交易订单和跟踪投资组合，从而构建更智能化的金融应用。

主要功能点

MCP 协议兼容: 遵循 Model Context Protocol 规范，提供标准化的上下文数据访问接口，方便 LLM 客户端集成。
Angle One 集成: 深度整合 Angle One 交易平台 API，利用其强大的金融数据和交易能力。
实时市场数据: 提供实时的股票市场行情数据，支持 LLM 应用进行市场分析和决策。
订单管理: 支持通过 LLM 客户端进行交易订单的下单、修改和取消等操作。
投资组合跟踪: 允许 LLM 应用查询和监控用户的投资组合信息。

安装步骤

克隆仓库: 打开终端，执行以下命令克隆仓库到本地：

git clone https://github.com/MCP-Mirror/baba786_angleone-mcp-server.git

进入项目目录:

cd baba786_angleone-mcp-server

安装依赖: 安装项目所需的 Python 依赖包：

pip install -r requirements.txt

配置环境变量: 在项目根目录下创建 '.env' 文件，并填入您的 Angle One API 凭证。请务必替换以下占位符为您实际的 API Key、Client ID、密码和 Token。

ANGLEONE_API_KEY=your_api_key
ANGLEONE_CLIENT_ID=your_client_id
ANGLEONE_PASSWORD=your_password
ANGLEONE_TOKEN=your_token

注意: 请妥善保管您的 API 凭证，避免泄露。

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 AngleOne MCP Server。

{
  "server_name": "AngleOne MCP Server",
  "command": "python",
  "args": ["src/main.py"]
}

'server_name': 服务器的名称，您可以自定义设置，用于在 MCP 客户端中标识该服务器。
'command': 启动服务器的命令，通常为 'python'，表示使用 Python 解释器来运行服务器。
'args': 启动命令的参数列表，这里指定运行 'src/main.py' 文件，即服务器的主程序入口。

基本使用方法

启动服务器: 在终端中，导航到项目根目录，并执行以下命令启动服务器：
```
python src/main.py
```
服务器默认会在 'http://localhost:8000' 启动并监听请求。
MCP 客户端交互: 配置您的 MCP 客户端，使其连接到 'http://localhost:8000'。客户端可以发送符合 MCP 协议的 JSON-RPC 请求与服务器进行通信。

目前，服务器支持以下命令（command）并在 'context' 中传递：
- 'get_profile': 获取 Angle One 用户profile信息。
- 'get_positions': 获取当前持仓信息。
- 'place_order': 进行下单交易，需要在 'parameters' 中提供订单参数。
具体的请求格式和参数定义需要参考 MCP 协议文档以及服务器端的 'src/main.py' 中 'generate' 方法的实现。

示例 (假设 MCP 客户端发送的请求):
```
{
  "jsonrpc": "2.0",
  "method": "MCP.generate",
  "params": {
    "context": {
      "command": "get_profile"
    }
  },
  "id": 1
}
```
服务器会返回包含用户 profile 信息的 JSON-RPC 响应。

请注意，这只是一个基础的 MCP 服务器实现，实际应用中可能需要根据具体需求扩展其功能和命令。

关键词