Bullhorn Crm MCP Server By Cdata

🚀 Bullhorn CRM MCP 服务器（由 CData 提供）

CData 为 Bullhorn CRM 打造的模型上下文协议（MCP）服务器，该服务器为只读模式，可让大语言模型（如 Claude Desktop）通过自然语言查询 Bullhorn CRM 中的实时数据。

:heavy_exclamation_mark: 本项目构建的是只读 MCP 服务器。若你需要完整的读、写、更新、删除和操作功能，以及更简化的设置，请查看我们免费的 CData MCP 服务器（适用于 Bullhorn CRM，测试版）。

🚀 快速开始

项目用途

我们创建这个只读 MCP 服务器，是为了让大语言模型（如 Claude Desktop）能够查询 Bullhorn CRM 中的实时数据。该服务器借助 CData JDBC 驱动（适用于 Bullhorn CRM） 实现数据连接。CData JDBC 驱动将 Bullhorn CRM 数据以关系型 SQL 模型的形式呈现，而此服务器对该驱动进行封装，通过简单的 MCP 接口提供 Bullhorn CRM 数据，使得大语言模型可以通过自然语言问题检索实时信息，无需使用 SQL。

安装指南

1. 克隆仓库

   git clone https://github.com/cdatasoftware/bullhorn-crm-mcp-server-by-cdata.git
   cd bullhorn-crm-mcp-server-by-cdata
   

2. 构建服务器

   mvn clean install
   

   此命令会生成 JAR 文件：CDataMCP-jar-with-dependencies.jar。
3. 下载并安装 CData JDBC 驱动 访问 https://www.cdata.com/drivers/bullhorncrm/download/jdbc 下载并安装适用于 Bullhorn CRM 的 CData JDBC 驱动。
4. 为 CData JDBC 驱动授权
   • 导航至安装目录下的 lib 文件夹，通常路径如下：
     • Windows：C:\Program Files\CData\CData JDBC Driver for Bullhorn CRM\
     • Mac/Linux：/Applications/CData JDBC Driver for Bullhorn CRM/
   • 运行命令 java -jar cdata.jdbc.bullhorncrm.jar --license。
   • 输入你的姓名、电子邮件和 “TRIAL”（或你的许可证密钥）。
5. 配置数据源连接（以 Salesforce 为例）
   • 运行命令 java -jar cdata.jdbc.bullhorncrm.jar 打开连接字符串实用程序。
   • 配置连接字符串并点击 “Test Connection”。

     注意：如果数据源使用 OAuth，你需要在浏览器中进行身份验证。

   • 连接成功后，复制连接字符串以备后续使用。
6. 创建 JDBC 连接的 .prp 文件（例如 bullhorn-crm.prp） 使用以下属性和格式：
   • Prefix：用于公开工具的前缀。
   • ServerName：服务器名称。
   • ServerVersion：服务器版本。
   • DriverPath：JDBC 驱动 JAR 文件的完整路径。
   • DriverClass：JDBC 驱动类的名称（例如 cdata.jdbc.bullhorncrm.BullhornCRMDriver）。
   • JdbcUrl：用于与 CData JDBC 驱动连接到数据的 JDBC 连接字符串（从上述步骤复制）。
   • Tables：留空以访问所有数据，否则可以明确声明要创建访问权限的表。

   Prefix=bullhorncrm
   ServerName=CDataBullhornCRM
   ServerVersion=1.0
   DriverPath=PATH\TO\cdata.jdbc.bullhorncrm.jar
   DriverClass=cdata.jdbc.bullhorncrm.BullhornCRMDriver
   JdbcUrl=jdbc:bullhorncrm:InitiateOAuth=GETANDREFRESH;
   Tables=
   

使用服务器与 Claude Desktop

1. 创建 Claude Desktop 的配置文件（claude_desktop_config.json） 以添加新的 MCP 服务器。如果文件已存在，将条目添加到配置文件的 mcpServers 中。 Windows

   {
       "mcpServers": {
           "{classname_dash}": {
               "command": "PATH\\TO\\java.exe",
               "args": [
                   "-jar",
                   "PATH\\TO\\CDataMCP-jar-with-dependencies.jar",
                   "PATH\\TO\\bullhorn-crm.prp"
               ]
           },
           ...
       }
   }
   

   Linux/Mac

   {
       "mcpServers": {
           "{classname_dash}": {
               "command": "/PATH/TO/java",
               "args": [
                   "-jar",
                   "/PATH/TO/CDataMCP-jar-with-dependencies.jar",
                   "/PATH/TO/bullhorn-crm.prp"
               ]
           },
           ...
       }
   }
   

   如果需要，将配置文件复制到相应目录（以 Claude Desktop 为例）。 Windows

   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json
   

   Linux/Mac

   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json
   

2. 运行或刷新客户端（Claude Desktop）

   注意：你可能需要完全退出或关闭 Claude Desktop 客户端，然后重新打开它，MCP 服务器才会显示。

运行服务器

运行以下命令以单独运行 MCP 服务器：

java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

注意：服务器使用 stdio，因此只能与在同一台机器上运行的客户端一起使用。

💻 使用示例

基础用法

配置好 MCP 服务器后，AI 客户端可以使用内置工具对底层数据进行读、写、更新和删除操作。一般来说，你无需显式调用这些工具，只需让客户端回答有关底层数据系统的问题即可。例如：

• "我已成交的机会与客户行业之间的相关性是什么？"
• "我在 SUPPORT 项目中有多少未解决的工单？"
• "你能告诉我今天有哪些日历事件吗？"

工具及描述

在以下定义中，{servername} 指的是配置文件中 MCP 服务器的名称（例如上述的 {classname_dash}）。

• {servername}_get_tables：检索数据源中可用表的列表。使用 {servername}_get_columns 工具列出表上的可用列。该工具的输出将以 CSV 格式返回，第一行包含列标题。
• {servername}_get_columns：检索表的列列表。使用 {servername}_get_tables 工具获取可用表的列表。该工具的输出将以 CSV 格式返回，第一行包含列标题。
• {servername}_run_query：执行 SQL SELECT 查询。

JSON - RPC 请求示例

如果你不使用 AI 客户端（如 Claude），而是通过脚本向 MCP 服务器发送请求，那么在调用可用工具时，可以参考以下遵循 JSON - RPC 2.0 规范的 JSON 有效负载示例。

source_get_tables

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "source_get_tables",
        "arguments": {}
    }
}

source_get_columns

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "source_get_columns",
        "arguments": {
            "table":  "Account"
        }
    }
}

source_run_query

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "source_run_query",
        "arguments": {
            "sql":  "SELECT * FROM [Account] WHERE [IsDeleted] = true"
        }
    }
}

📚 详细文档

故障排除

1. 在 Claude Desktop 中看不到 CData MCP 服务器：确保你已完全退出 Claude Desktop（Windows：使用任务管理器，Mac：使用活动监视器）。
2. Claude Desktop 无法检索数据：确保你已正确配置连接。使用连接字符串构建器创建连接字符串（见上述步骤），并将连接字符串复制到属性（.prp）文件中。
3. 连接数据源时遇到问题：联系 CData 支持团队。
4. 使用 MCP 服务器时遇到问题或有其他反馈：加入 CData 社区。

许可证

此 MCP 服务器遵循 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。

所有支持的数据源

📄 许可证

此 MCP 服务器遵循 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。