内容
# 交易平台连接服务器
一个模型上下文协议（MCP）服务器，允许AI模型与交易平台进行交互。该项目提供了一套工具，用于通过标准化的接口在交易平台上执行交易、查看投资组合和管理仓位。
## 功能特点
- 🔐 安全的交易平台API认证
- 📊 查看投资组合持仓
- 📈 查看当前仓位
- 💹 下达买入/卖出订单
- 👤 访问用户信息
## 前置条件
- Node.js（v14或更高版本）
- 交易平台交易账户
- 交易平台API凭证
## 安装
1. 克隆仓库：
```bash
git clone https://github.com/shubhamprajapati7748/zerodha-trade-mcp.git
cd zerodha-trade-mcp
```
2. 安装依赖：
```bash
npm install
```
3. 在根目录中创建一个`.env`文件，并填写交易平台凭证：
```env
KITE_API_KEY=您的API密钥
KITE_SECRET_KEY=您的密钥
REQUEST_TOKEN=您的请求令牌
ACCESS_TOKEN=您的访问令牌
```
## Claude Desktop MCP 配置
要将此MCP服务器与Claude Desktop一起使用，您需要配置MCP服务器的详细信息。以下是设置方法：
1. 在项目根目录中打开`claude_desktop_config.json`
2. 添加以下配置：
```json
{
"mcpServers": {
"tradeStocks": {
"command": "/opt/homebrew/bin/bun",
"args": [
"/path/to/your/index.ts"
],
"env": {
"KITE_API_KEY": "您的API密钥",
"KITE_SECRET_KEY": "您的密钥",
"REQUEST_TOKEN": "您的请求令牌",
"ACCESS_TOKEN": "您的访问令牌"
}
}
}
}
```
确保：
- 更新到您的`index.ts`文件的路径
- 用实际的交易平台凭证替换环境变量
## 使用
MCP服务器提供以下工具：
### 获取用户信息
```typescript
get-profile
```
从交易平台检索用户信息。
### 买入股票
```typescript
buy-stock {stock: string, quantity: number}
```
下达买入订单，购买指定股票和数量。
### 卖出股票
```typescript
sell-stock {stock: string, quantity: number}
```
下达卖出订单，卖出指定股票和数量。
### 显示投资组合
```typescript
show-portfolio
```
显示用户的完整投资组合持仓。
### 显示仓位
```typescript
show-positions
```
显示用户的当前仓位。
## 开发
该项目使用以下技术构建：
- TypeScript
- KiteConnect API
- 模型上下文协议（MCP）SDK
- Zod进行模式验证
## 贡献
欢迎贡献！请随时提交拉取请求。
## 许可证
该项目在MIT许可证下许可 - 有关详细信息，请参见LICENSE文件。
## 免责声明
本项目仅用于教育目的。金融市场交易存在重大风险。请始终进行自己的研究并负责任地交易。
