表格自然语言处理客户端

该服务通过OpenAI将自然语言消息转换为JSON命令,用于操作Google Sheets表格,适用于自动化数据处理场景。

  • by dieLopes
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dieLopes/sheets-openai-mcp-client

使用说明

Sheets OpenAI 客户端

客户端查询MCP信息并使用OpenAI进行解析 自然语言信息 并生成JSON命令以操作Google Sheets电子表格。

它与一个(系统/设备)协同工作。 执行服务 (sheets-mcp-server) 在电子表格中执行操作。


⚙️ 功能

  • 接收用户以自然语言发送的消息。
  • 寻找MCP接受的JSON格式
  • 将消息转换为一个 结构化的JSON命令。
  • 将命令发送到服务 sheets-mcp-server.
  • 将执行结果返回给用户。

⚡ 设置

  1. 创建一个文件 .env 在根源上:
SHEET_MCP_URL=http://localhost:5000/executar
OPENAI_API_KEY=your_openai_api_key_here
SHEET_NAME=Nome_planilha
GPT_MODEL=gpt-3.5-turbo
  1. 安装依赖项:
pip install -r requirements.txt
  1. 本地运行
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

终点(或:结局指标)

方法 终点 描述
POST /message 接收用户消息,生成JSON命令并调用执行器
GET /mcp.json 返回服务器的MCP清单文件

/message 请求示例:

{
  "mensagem": "Adicione uma despesa de 120 reais na categoria alimentação"
}

🧩 流程架构

用户向mcp-openai-server发送消息。

该服务寻找mcp.json以验证端点输入的格式。

服务器将提示符+消息发送给OpenAI。

OpenAI返回结构化的JSON。

服务器使用命令调用 sheets-mcp-server。

sheets-mcp-server 在 Google Sheets 表格上执行操作。

结果返回给用户。

📝 可配置的提示

GPT的提示符位于:

应用程序/提示/表格代理提示文件.py

结构示例:

sheet_agent_prompt = [
    {"role": "system", "content": "..."},
    {"role": "user", "content": "..."}
]