Skip to content

MCP客户端调用说明.md

Latest commit

 

History

History
70 lines (52 loc) · 2.19 KB

MCP客户端调用说明.md

File metadata and controls

70 lines (52 loc) · 2.19 KB
Raw

MCP 客户端调用说明

在 Cursor / Trae 里用（推荐）

不需要在本机执行 script/mcp_sse_call.py 或任何 Python 脚本。

  1. 打开 IDE → Settings → MCP
  2. 添加服务器（示例）：
{
  "mcpServers": {
    "db-mcp-warehouse": {
      "url": "https://你的域名/mcp/sse",
      "headers": {
        "X-Access-Key": "你的访问密钥"
      }
    }
  }
}
  1. 在对话里直接让 AI 调用工具，例如：generate_er_diagram、export_db_doc
  2. 改工具、换参数都由 IDE 的 MCP 客户端自动完成，与 mcp_sse_call.py 无关

命令行 / CI / 其他工具（通用脚本）

使用 script/mcp_call.py（包装 SSE，支持任意工具名）：

# Windows PowerShell
$env:MCP_SSE_URL = "https://mcp.wongcw.cn/mcp/sse"
$env:MCP_ACCESS_KEY = "你的密钥"

# 列出连接
python script/mcp_call.py --tool list_connections

# 生成 ER PDF 并上传 OSS（参数放 json 文件）
python script/mcp_call.py --tool generate_er_diagram --args script/er_pdf_args.json

er_pdf_args.json 示例：

{
  "connection_id": 1,
  "database": "whcenter",
  "format": "pdf",
  "upload_to_oss": true
}

简易 HTTP 模式（若服务端开启了 /mcp/call）

python script/mcp_call.py --http --base https://mcp.wongcw.cn \
  --tool list_tables --args "{\"connection_id\":1}"

PDF ER 图说明

  • 中文乱码/叠字：镜像须内置 NotoSansCJKsc-Regular.otf（Dockerfile 构建时下载）；勿优先用 .ttc（fpdf2 易错 face 索引）。部署后日志应出现 PDF 中文字体: ...NotoSansCJKsc-Regular.otf
  • ER/数据流默认使用服务端元数据生成 Mermaid + 文字摘要，不再依赖 SchemaCrawler/tbls 等重型组件。
  • 若运行环境额外安装 mermaid-cli (mmdc) + Chromium，PDF 会把 Mermaid 分片渲染成 PNG 嵌入；未安装时 PDF 保留摘要与 Mermaid 源码预览。
  • 表特别多（如 400+）会按业务域分片，建议优先用 format=markdown 获取完整 Mermaid 和数据字典。

与 mcp_sse_call.py 的关系

  • mcp_sse_call.py：底层 SSE 实现，一般被 mcp_call.py 调用
  • 新工具只需改 --tool 和 --args，不必再写新脚本