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 文件。