项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专门用于连接 Pipedrive CRM 系统。它允许大型语言模型(LLM)应用通过标准化的 MCP 协议,安全地访问和操作 Pipedrive 中的客户关系数据。

主要功能点

  • 数据访问: 提供对 Pipedrive 数据的只读访问,包括交易 (deals)、人员 (persons)、组织 (organizations) 和管道 (pipelines) 等资源,并支持自定义字段。
  • 工具 (Tools): 预置了一系列工具,例如获取交易列表、搜索人员、查询组织信息等,方便 LLM 应用调用以获取特定数据。
  • Prompt 模板 (Prompts): 提供预定义的 Prompt 模板,用于常见的 Pipedrive 数据分析和查询任务,简化 LLM 应用的交互流程。

安装步骤

  1. 克隆仓库: 将 GitHub 仓库 'https://github.com/WillDent/pipedrive-mcp-server' 克隆到本地。
  2. 安装依赖: 在项目根目录下运行 'npm install' 命令安装项目依赖。
  3. 配置环境变量: 在项目根目录下创建 '.env' 文件,并添加 Pipedrive API Token:
    PIPEDRIVE_API_TOKEN=你的_Pipedrive_API_Token
  4. 构建项目: 运行 'npm run build' 命令构建项目。
  5. 启动服务器: 运行 'npm start' 命令启动 MCP 服务器。

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以 Claude Desktop 为例,需要在 'claude_desktop_config.json' 文件中添加如下服务器配置:

{
  "mcpServers": {
    "pipedrive": {
      "server name": "pipedrive",
      "command": "node",
      "args": ["/path/to/pipedrive-mcp-server/build/index.js"],
      "env": {
        "PIPEDRIVE_API_TOKEN": "你的_Pipedrive_API_Token"
      }
    }
  }
}

配置参数说明:

  • 'server name': 'pipedrive' (服务器名称,客户端用于标识和调用)
  • 'command': 'node' (启动服务器的命令)
  • 'args': '["/path/to/pipedrive-mcp-server/build/index.js"]' (启动命令的参数,指向服务器入口文件 'index.js' 的构建后路径,请替换 '/path/to/pipedrive-mcp-server' 为实际的项目本地路径)
  • 'env': '{ "PIPEDRIVE_API_TOKEN": "你的_Pipedrive_API_Token" }' (环境变量,用于传递 Pipedrive API Token,请替换为实际 Token)

注意: '/path/to/pipedrive-mcp-server' 需要替换为 'pipedrive-mcp-server' 项目在您本地文件系统中的实际路径。

基本使用方法

完成服务器配置后,在 MCP 客户端(如 Claude)中,即可看到名为 'pipedrive' 的服务器及其提供的 Tools 和 Prompts。用户可以通过选择相应的 Tools 或 Prompts,与 Pipedrive 数据进行交互。例如,可以使用 'list-all-deals' Prompt 获取所有交易列表,或使用 'search-persons' Tool 搜索特定人员信息。

信息

分类

商业系统