Zerodha MCP

🚀 Zerodha MCP 集成

本項目藉助多雲插件（MCP）框架，將 Zerodha 交易平臺與 Claude AI 進行集成。通過該集成，您能夠直接通過 Claude 與您的 Zerodha 交易賬戶進行交互。

🚀 快速開始

本項目可幫助您將 Zerodha 交易平臺與 Claude AI 集成，通過 Claude 直接交互您的 Zerodha 交易賬戶。以下為您詳細介紹安裝、設置、使用等步驟。

✨ 主要特性

• 實現 Zerodha 交易平臺與 Claude AI 的集成。
• 提供多種 MCP 工具，涵蓋認證、股票/通用交易、現金管理等功能。
• 確保認證和數據的安全性，憑證僅本地存儲。

📦 安裝指南

使用 Smithery 安裝

要通過 Smithery 自動為 Claude Desktop 安裝 zerodha - mcp，可使用以下命令：

npx -y @smithery/cli install @aptro/zerodha-mcp --platform windows

💻 使用示例

基礎用法

認證

1. 在您的項目中，導入必要的命名空間：

using ZerodhaMCP;
using Microsoft.Extensions.Configuration;

2. 初始化配置和 MCP 實例：

var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json")
    .Build();

IMCP zerodhaMcp = new ZerodhaMCP.ZerodhaMCPClient(configuration);

3. 使用 MCP 工具：

// 獲取請求令牌
var requestToken = await zerodhaMcp.GetRequestTokenAsync();

// 初始化登錄流程
await zerodhaMcp.InitiateLogin(requestToken.token, "http://localhost:8080");

📚 詳細文檔

設置說明

創建開發者賬戶

1. 訪問 Kite Portal 並註冊一個開發者賬戶。
2. 登錄後轉到“API 賬戶”部分，創建一個新的 API 賬戶。
3. 記錄生成的 API Key 和 Secret Key。

生成 API 憑證

1. 在項目的根目錄中，創建兩個文件：

   • appsettings.json
   • zerodha_credentials.json

2. 將以下內容添加到 appsettings.json：

{
  "Zerodha": {
    "KiteApiKey": "your_api_key_here",
    "KiteSecretKey": "your_secret_key_here"
  }
}

3. 將以下內容添加到 zerodha_credentials.json：

{
  ".consumer_key": "your_api_key_here",
  "consumer_secret": "your_secret_key_here",
  "access_token": null,
  "access_token_secret": null
}

可用的 MCP 工具

認證

• CheckAndAuthenticate - 驗證認證狀態並按需發起登錄
• InitiateLogin - 啟動 Zerodha 登錄流程
• GetRequestToken - 獲取請求令牌

股票/通用交易

• PlaceOrder - 下單
• ModifyOrder - 修改訂單
• CancelOrder - 撤銷訂單
• GetPosition - 獲取頭寸
• GetHoldings - 獲取持倉
• GetQuotes - 獲取報價
• GetHistoricalData - 獲取歷史數據

現金管理

• PlaceMFOrder - 下基金單
• ModifyMFOrder - 修改基金訂單
• CancelMFOrder - 撤銷基金訂單
• GetMFHoldings - 獲取基金持倉
• GetMFSips - 獲取 SIP
• PlaceMFSip - 創建 SIP
• ModifyMFSip - 修改 SIP
• CancelMFSip - 取消 SIP

故障排除

• 如果出現認證問題，請嘗試刪除 .tokens 文件並重新啟動登錄流程。
• 確保 appsettings.json 和 zerodha_credentials.json 中的憑證正確無誤。
• 確保端口 8080 未被其他應用程序佔用。
• 如需幫助，請訪問 Zerodha 開發者論壇

安全注意事項

• 您的 Zerodha API 憑證僅存儲在本地 appsettings.json 文件中。
• 訪問令牌存儲在項目目錄中的 .tokens 文件中。
• 無憑證會傳輸到 Claude 或任何第三方。
• 所有認證直接發生在您和 Zerodha 的服務器之間。