项目简介

ContextCraft 是一个智能的、兼容大型语言模型（LLM）的上下文协议（MCP）服务器，它允许 LLM 代理（如 Claude）通过连接 Zerodha KiteConnect 平台执行实时的股票交易操作。通过自然语言指令，LLM 可以调用服务器提供的工具来买卖股票。

主要功能点

• 股票交易下单: 支持市价单和限价单，可以指定股票代码、买卖方向、数量和价格。
• 股票代码查询: 可以通过输入股票代码的子字符串来查找匹配的交易符号。
• 与LLM客户端集成: 专为与支持 MCP 协议的 LLM 客户端（如 Claude Desktop）无缝协作而设计。

安装步骤

1. 克隆仓库: 打开终端或命令提示符，执行以下命令将项目代码下载到本地：

   git clone https://github.com/arindhimar/contextcraft.git
   cd contextcraft
   

2. 创建并激活虚拟环境: 推荐使用虚拟环境隔离项目依赖，避免冲突：

   python -m venv .venv
   source .venv/bin/activate  # Windows 用户请运行: .venv\Scripts\activate
   

3. 安装依赖: 使用 uv 工具安装项目所需的依赖库（uv 会在安装时自动下载）：

   uv pip install -e .
   

4. 配置 .env 文件: 在项目根目录创建一个名为 '.env' 的文件，并填入你的 Zerodha KiteConnect API 密钥和访问令牌。请确保此文件不会被版本控制系统（如 Git）上传。

   API_KEY=你的_kiteconnect_key
   ACCESS_TOKEN=你的_有效_访问_令牌
   

服务器配置（适用于 MCP 客户端）

要将 ContextCraft 服务器连接到支持 MCP 的 LLM 客户端（例如 Claude Desktop），你需要在客户端的配置中添加服务器信息。这通常涉及指定服务器名称、启动服务器的命令及其参数。

以下是配置所需的关键信息：

• 服务器名称 (Server Name): ContextCraft
• 启动命令 (Command): uv
• 命令参数 (Arguments): '--directory', '[你的项目目录路径]\mcp-server-ContextCraft', 'run', 'python', 'server.py'
  • 请将 '[你的项目目录路径]' 替换为你实际将仓库克隆到的路径。
  • 例如，如果你的项目在 'C:\Users\YourName\Documents\ContextCraft'，则参数应包含 'C:\Users\YourName\Documents\ContextCraft\mcp-server-ContextCraft'。

根据你的 LLM 客户端类型，将以上信息填入其 MCP 服务器配置界面或文件中（具体格式请参考客户端文档）。配置完成后，重新加载客户端设置即可连接服务器。

基本使用方法

连接成功后，通过你的 LLM 客户端，你可以使用自然语言向 ContextCraft 服务器发送请求。服务器会解析这些请求并调用相应的工具来执行操作。

例如，你可以尝试发送如下指令给 LLM：

• “Buy 10 shares of INFY at market price.” (买入 10 股 INFY，市价成交)
• “Sell 5 SBIN when it hits 780.” (当 SBIN 达到 780 时，卖出 5 股 - 这将调用服务器的交易工具，并根据指令参数下单)

服务器会执行相应的交易操作，并将结果（如订单 ID）返回给 LLM。