CSV文件上传代理服务器

一个作为SDR后端代理的MCP服务器,允许AI代理将CSV文件上传到活动中。

  • by darpan-ruh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 darpan-ruh/proxy-mcp-server

使用说明

代理MCP服务器

MCP(模型上下文协议)服务器,充当SDR后端的代理,使AI代理能够将CSV文件上传到活动。

可用工具

upload_csv

将客户从CSV文件上传到活动中。

参数:

名称 类型 必填 描述
user_id string 是 用户的ID
conversation_id string 是 活动/对话的ID
csv_url string 是 要上传的CSV文件的URL
force_proceed boolean 否 即使缺少可选标头也强制上传

设置

1.安装依赖项

uv venv
uv pip install -e .

2.配置环境

创建一个 .env 文件:

SERVER_AUTH_KEY=your-backend-auth-key
BACKEND_URL=http://localhost:8000/api/v1
HOST=0.0.0.0
PORT=8001

3.运行服务器

uv run python -m src.server

4.通过Cloudflare隧道暴露(用于远程访问)

cloudflared tunnel --url http://localhost:8001

使用AI代理

反重力/光标/VS码

添加到MCP配置中:

{
  "mcpServers": {
    "sdr-proxy": {
      "url": "https://your-tunnel-url.trycloudflare.com/mcp",
      "transport": "streamable-http"
    }
  }
}

克劳德桌面(本地)

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "sdr-proxy": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/proxy-mcp-server",
        "run",
        "python",
        "-m",
        "src.server"
      ],
      "env": {
        "SERVER_AUTH_KEY": "your-backend-auth-key",
        "BACKEND_URL": "http://localhost:8000/api/v1"
      }
    }
  }
}

MCP检验员测试

npx @modelcontextprotocol/inspector http://localhost:8001/mcp

这将打开一个浏览器UI,您可以在其中测试工具。

API终点

端点 方法 描述
/ GET 健康检查
/mcp POST MCP的流式HTTP端点

建筑

AI Agent 
        ↓
        ↓ (StreamableHTTP)
        ↓
[Proxy MCP Server] ──→ localhost:8000 (SDR Backend)
        ↑
        ↑ (Cloudflare Tunnel for remote access)
        ↑
Remote AI Agents

需求

  • Python 3.10+
  • uv(Python包管理器)
  • 在端口8000上运行SDR后端
  • cloudflared(用于远程访问)