典枢MCP工具安装教程

典枢数据平台（dianshudata.com）的 MCP 服务——为 AI Agent 提供典枢平台的完整操作能力，包括登录、订单管理、数据下载、API 调用、数据集搜索等。

仓库地址

• GitHub: https://github.com/YeeZTech/dianshu-mcp
• Gitee: https://gitee.com/YeeZTech/dianshu-mcp

部署说明

方式一（推荐）：从 Releases 安装

1. 下载最新 Release 的压缩包（根据系统选择）：
   • macOS Apple Silicon（M1/M2/M3）：macos-arm64.zip
   • macOS Intel：macos-amd64.zip
   • Linux x86_64：linux-amd64.zip
   • Linux arm64：linux-arm64.zip
   • Windows x86_64：windows-amd64.zip
   • Windows arm64：windows-arm64.zip
2. 解压后会得到：
   • 可执行文件：dianshu-mcp（Windows 为 dianshu-mcp.exe）
   • skills 目录：skills/

方式二：源码编译安装

前提条件：Go 1.22+（所有平台）、Git

# 从 GitHub 克隆
git clone https://github.com/YeeZTech/dianshu-mcp.git
# 或从 Gitee 克隆
git clone https://gitee.com/YeeZTech/dianshu-mcp.git

cd dianshu-mcp
go build -o dianshu-mcp .

启动服务

./dianshu-mcp -headless=true

输出目录：

• 数据文件：~/Downloads/dianshu-mcp/downloads/
• API 结果：~/Downloads/dianshu-mcp/api-data/

导入 Skills & 配置 MCP

将 .skill/dianshu/ 复制到对应 Agent 的 skills 目录，然后配置 MCP 连接。两步都必须完成。

Hermes

导入 Skills： cp -r .skill/dianshu ~/.hermes/skills/

配置 MCP（~/.hermes/config.yaml）：

mcp_servers:
  dianshu-mcp:
    transport: streamable-http
    url: http://localhost:18061/mcp

或通过命令：hermes config set mcp_servers.dianshu-mcp.transport streamable-http 和 hermes config set mcp_servers.dianshu-mcp.url http://localhost:18061/mcp

Claude Code

导入 Skills： cp -r .skill/dianshu .claude/skills/

配置 MCP（.claude/settings.json）：

{
  "mcpServers": {
    "dianshu-mcp": {
      "type": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

⚠️ Claude Code 使用 "type" 字段，非 "transport"。

Cursor

导入 Skills： cp -r .skill/dianshu .cursor/skills/

配置 MCP（.cursor/mcp.json）：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

Trae / Trae Solo

导入 Skills： cp -r .skill/dianshu .trae/skills/

配置 MCP： 打开设置 → MCP → 手动添加，或编辑 .trae/mcp.json：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

WorkBuddy

导入 Skills： cp -r .skill/dianshu .workbuddy/skills/

配置 MCP： 点击侧栏 CodeBuddy Settings → MCP → Add MCP，在 JSON 中添加，或编辑 .workbuddy/mcp.json：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

Augment Code

导入 Skills： cp -r .skill/dianshu .augment/skills/

配置 MCP（.augment/mcp.json）：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

Windsurf

导入 Skills： cp -r .skill/dianshu .windsurf/skills/

配置 MCP（.windsurf/mcp.json）：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

通义灵码

导入 Skills： cp -r .skill/dianshu .tongyi/skills/

配置 MCP： 右上角头像 → 个人设置 → MCP 服务 → + → 手工添加（SSE 类型，填名称和 http://localhost:18061/mcp），或编辑 .tongyi/mcp.json：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

VS Code / Cline

导入 Skills： cp -r .skill/dianshu .vscode/skills/

配置 MCP（项目根目录 mcp.json 或 Cline 扩展设置）：

{
  "mcpServers": {
    "dianshu-mcp": {
      "transport": "streamable-http",
      "url": "http://localhost:18061/mcp"
    }
  }
}

开始使用

Agent 连接成功后，说「登录典枢」即可扫码登录。之后可用自然语言操作：

• 「帮我查已购数据」→ 列出所有订单
• 「下载任务 xxx」→ 自动下载并解密
• 「搜索天气数据集」→ 搜索平台数据
• 「调用小红书 API」→ 调用已购数据 API

常见问题

安装后 Agent 没有加载到 MCP 工具？

Skills 和 MCP 是两个独立配置，漏了任何一个都会失败。逐一确认：

1. Skills 已复制到 Agent 的 skills 目录？
2. MCP 配置文件中已添加 http://localhost:18061/mcp？
3. dianshu-mcp 服务正在运行？
4. 重启 Agent

仍不行则手动调用 check_login_status 验证连接。

MCP 工具清单（19 个）

账户与登录

订单与下载

数据集搜索

个人中心