MCP 客户端接入

通过 MCP (Model Context Protocol) 协议，将 jisuapi Agent 服务集成到 Cursor、Claude Desktop 等支持 MCP 的 AI 工具中。

Cursor 配置

配置文件位置

• macOS / Linux: ~/.cursor/mcp.json
• Windows: %APPDATA%\.cursor\mcp.json

配置内容

编辑配置文件，添加以下内容：

{
  "mcpServers": {
    "jisuapi": {
      "command": "npx",
      "args": ["-y", "@jisuapi/mcp"],
      "env": {
        "JISUAPI_KEY": "你的APPKEY"
      }
    }
  }
}

配置说明

字段	说明
command	执行命令，使用 npx 自动安装和运行
args	命令参数，-y 表示自动确认安装
env.JISUAPI_KEY	你的 APPKEY，从会员中心获取

Claude Desktop 配置

配置文件位置

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

配置内容

编辑配置文件，添加以下内容：

{
  "mcpServers": {
    "jisuapi": {
      "command": "npx",
      "args": ["-y", "@jisuapi/mcp"],
      "env": {
        "JISUAPI_KEY": "你的APPKEY"
      }
    }
  }
}

验证接入

测试查询

配置完成并重启后，在对话框中输入：

帮我查询手机号 13800138000 的归属地

成功标志

如果看到以下情况，说明接入成功：

• AI 显示正在调用 jisuapi 工具
• 返回了具体的归属地信息（如：北京 中国移动）
• 显示了调用的接口名称

使用示例

常用查询

1. 查询手机号归属地

帮我查询 13800138000 的归属地

2. 查询天气

帮我查询北京的天气

3. 查询IP地址

帮我查询 8.8.8.8 的IP信息

4. 身份证验证

帮我验证身份证号 110101199001011234

提示词技巧

• 使用自然语言描述需求，无需记忆接口名称
• 可以连续查询，AI 会记住上下文
• 支持复杂查询，如"查询这个手机号的归属地，然后查询那个城市的天气"

常见问题

Q: 配置后不生效？

A: 请检查：

• 配置文件路径是否正确
• JSON 格式是否正确（注意逗号、引号）
• APPKEY 是否正确且未过期
• 是否重启了 Cursor 或 Claude Desktop

Q: 找不到配置文件？

A: 如果配置文件不存在，需要手动创建：

• 创建对应目录（如果不存在）
• 创建 JSON 文件
• 添加配置内容

Q: npx 命令找不到？

A: 请确保已安装 Node.js（建议 v16 或更高版本）：

• 访问 nodejs.org 下载安装
• 安装后重启终端或 IDE
• 运行 node -v 和 npx -v 验证

Q: AI 说找不到工具？

A: 可能的原因：

• 查询的功能暂不支持，查看可用接口列表
• MCP 服务未正确启动，重启客户端
• 网络连接问题，检查网络设置

高级配置

自定义超时时间

{
  "mcpServers": {
    "jisuapi": {
      "command": "npx",
      "args": ["-y", "@jisuapi/mcp"],
      "env": {
        "JISUAPI_KEY": "你的APPKEY",
        "TIMEOUT": "30000"
      }
    }
  }
}

启用调试日志

{
  "mcpServers": {
    "jisuapi": {
      "command": "npx",
      "args": ["-y", "@jisuapi/mcp"],
      "env": {
        "JISUAPI_KEY": "你的APPKEY",
        "DEBUG": "true"
      }
    }
  }
}

下一步

• 查看可用接口 - 了解所有支持的功能
• 常见问题 - 更多疑难解答
• HTTP 网关 - 了解 HTTP 接入方式