项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专门用于连接 Pipedrive CRM 系统。它允许大型语言模型(LLM)应用通过标准化的 MCP 协议,安全地访问和操作 Pipedrive 中的客户关系数据。
主要功能点
- 数据访问: 提供对 Pipedrive 数据的只读访问,包括交易 (deals)、人员 (persons)、组织 (organizations) 和管道 (pipelines) 等资源,并支持自定义字段。
- 工具 (Tools): 预置了一系列工具,例如获取交易列表、搜索人员、查询组织信息等,方便 LLM 应用调用以获取特定数据。
- Prompt 模板 (Prompts): 提供预定义的 Prompt 模板,用于常见的 Pipedrive 数据分析和查询任务,简化 LLM 应用的交互流程。
安装步骤
- 克隆仓库: 将 GitHub 仓库 'https://github.com/WillDent/pipedrive-mcp-server' 克隆到本地。
- 安装依赖: 在项目根目录下运行 'npm install' 命令安装项目依赖。
- 配置环境变量: 在项目根目录下创建 '.env' 文件,并添加 Pipedrive API Token:
PIPEDRIVE_API_TOKEN=你的_Pipedrive_API_Token - 构建项目: 运行 'npm run build' 命令构建项目。
- 启动服务器: 运行 '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 搜索特定人员信息。
信息
分类
商业系统