Agent 集成指南

概述

GroundAPI 提供 MCP（Model Context Protocol） 原生支持，AI Agent 可以直接调用 10 个工具获取金融、信息、生活服务数据，无需写任何代码。

支持的 AI 客户端：

Claude Desktop — Anthropic 官方桌面客户端
Cursor — AI 代码编辑器
Windsurf / Cline / Continue — 其他支持 MCP 的 IDE 插件
自定义 Agent — 任何支持 MCP 协议的应用

方式一：远程 MCP（推荐）

无需安装任何东西，直接连接 GroundAPI 的远程 MCP Server。

Claude Desktop

编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "groundapi": {
      "url": "https://mcp.groundapi.net/mcp",
      "env": {
        "GROUNDAPI_API_KEY": "你的API Key"
      }
    }
  }
}

Cursor

在 Cursor Settings → MCP 中添加：

{
  "mcpServers": {
    "groundapi": {
      "url": "https://mcp.groundapi.net/mcp",
      "env": {
        "GROUNDAPI_API_KEY": "你的API Key"
      }
    }
  }
}

其他 MCP 客户端

只需要端点地址和 API Key：

Endpoint: https://mcp.groundapi.net/mcp
Header: X-API-Key: 你的API Key

方式二：本地 MCP（stdio 模式）

适合需要离线使用或自定义配置的场景。

安装

pip install groundapi-cli

配置

Claude Desktop / Cursor 配置：

{
  "mcpServers": {
    "groundapi": {
      "command": "python",
      "args": ["-m", "mcp.server"],
      "env": {
        "GROUNDAPI_API_KEY": "你的API Key",
        "GROUNDAPI_BASE_URL": "https://api.groundapi.net"
      }
    }
  }
}

可用工具一览

安装完成后，Agent 可以使用以下 10 个工具：

金融数据

工具	功能	示例提问
`finance_stock`	股票搜索/行情/历史/技术指标	"贵州茅台现在多少钱？"
`finance_stock_screen`	条件选股/排行	"找 PE 小于 20 的半导体股票"
`finance_market`	市场全景/板块/基金/宏观	"今天大盘怎么样？"
`finance_fund`	基金搜索/排名/详情	"年初至今收益最好的基金"

信息服务

工具	功能	示例提问
`info_search`	网络搜索	"搜一下最新的 AI Agent 框架"
`info_scrape`	网页抓取	"帮我看看这个网页说了什么"
`info_news`	新闻热点	"今天有什么财经新闻？"

生活服务

工具	功能	示例提问
`life_weather`	天气查询/7天预报	"北京今天天气怎么样？"
`life_logistics`	快递追踪	"查一下顺丰 SF1234567890 到哪了"
`life_ip`	IP 地理定位	"8.8.8.8 是哪里的？"

多工具组合示例

AI Agent 可以自动组合多个工具完成复杂任务：

"帮我查一下贵州茅台的行情和最近的新闻"

Agent 会自动调用 finance_stock 获取实时行情 → info_search 搜索相关新闻。

"找 PE 小于 15 的半导体股票，顺便看看大盘走势"

Agent 会自动：

调用 finance_stock_screen 筛选目标股票
调用 finance_market 获取大盘和板块数据

常见问题

连接不上 MCP Server？

确认 API Key 正确（在控制台查看）
确认网络可以访问 mcp.groundapi.net
重启 Claude Desktop / Cursor

工具调用返回错误？

查看返回的 error.code：

INVALID_API_KEY — API Key 无效，重新检查
RATE_LIMIT_EXCEEDED — 请求太频繁，等一会儿再试
INVALID_PARAMS — 参数格式不对，检查输入
DATA_SOURCE_TIMEOUT — 上游数据源超时，稍后重试

免费额度够用吗？

每月 500 次免费调用，覆盖所有 10 个工具。超出后按量计费，详见定价。