Actionkit MCP Starter

🚀 ActionKit MCP 啟動器

本項目是一個用於演示 ActionKit 的 MCP 服務器的倉庫。將該服務器連接到 Claude Desktop 或 Cursor 後，您就能訪問所有 ActionKit 的 Slack 動作。此示例假設用戶已通過 Paragon Connect Portal 完成身份驗證。為方便演示，我們對 Slack 動作進行了過濾，若您有需要，可通過移除 index.ts 文件中的 Slack 過濾器來更改這一設置。

🚀 快速開始

✨ 主要特性

• 連接 Claude Desktop 或 Cursor 以訪問 ActionKit 的 Slack 動作。
• 支持用戶通過 Paragon Connect Portal 進行身份驗證。
• 可通過移除 index.ts 文件中的 Slack 過濾器來調整動作顯示。

📦 安裝指南

Claude Desktop 設置

1. 安裝 Claude Desktop：首先確保您已安裝 Claude Desktop。
2. 克隆倉庫並安裝依賴：克隆此倉庫，然後在倉庫目錄下運行 npm install 命令。
3. 構建 JavaScript 文件：運行 npm run build 命令，構建一個供 Claude Desktop 使用的 JavaScript 文件。
4. 配置 Claude Desktop 指向 MCP 服務器：
   • 創建/編輯配置文件：使用文本編輯器（例如 vi ~/Library/Application\ Support/Claude/claude_desktop_config.json）創建或編輯 Claude 配置文件。
   • 粘貼配置內容：在 claude_desktop_config.json 文件中粘貼以下配置：

{
    "mcpServers": {
      "mcp-actionkit": {
            "command": "node",
            "args": [
                "ABSOLUTE_PATH/actionkit-mcp-starter/build/index.js"
            ],
            "env": {
                "USER": "",
                "PARAGON_PROJECT_ID": "",
                "SIGNING_KEY":""
            }
        }
    }
}

- **填寫環境變量**：使用 Paragon 資格填寫環境變量。對於 `USER` 環境變量，它對應於通過 Paragon Connect Portal 登錄的已登錄用戶。您可以使用 [demo.useparagon.com](https://demo.useparagon.com) 快速登錄為您的用戶並 **驗證 Slack**（這是使用 Slack 工具代表您執行操作所必需的）。
- **獲取絕對路徑**：注意，`ABSOLUTE_PATH` 可以通過在 Mac 的 `Finder` 中按 `CMD` 點擊文件來找到。

5. 驗證設置：打開 Claude Desktop，此時應該會出現一個帶有 Slack 工具列表的 錘子圖標。此外，在 連接圖標 處也應該可以看到您的應用程序已連接到我們的 MCP。

Cursor 設置

1. 安裝 Cursor：若尚未安裝 Cursor，請先進行安裝。
2. 克隆倉庫並安裝依賴：克隆此倉庫，然後在倉庫目錄下運行 npm install 命令。
3. 構建 JavaScript 文件：運行 npm run build 命令，構建一個供 Cursor 使用的 JavaScript 文件。
4. 配置 Cursor 指向 MCP 服務器：
   • 創建/編輯配置文件：使用文本編輯器（例如 vi ~/.cursor/mcp.json）創建或編輯 Cursor 配置文件。
   • 粘貼配置內容：在 mcp.json 文件中粘貼以下配置：

{
    "mcpServers": {
      "mcp-actionkit": {
            "command": "node",
            "args": [
                "ABSOLUTE_PATH/actionkit-mcp-starter/build/index.js"
            ],
            "env": {
                "USER": "",
                "PARAGON_PROJECT_ID": "",
                "SIGNING_KEY":""
            }
        }
    }
}

- **填寫環境變量**：使用 Paragon 資格填寫環境變量。對於 `USER` 環境變量，它對應於通過 Paragon Connect Portal 登錄的已登錄用戶。您可以使用 [demo.useparagon.com](https://demo.useparagon.com) 快速登錄為您的用戶並 **驗證 Slack**（這是使用 Slack 工具代表您執行操作所必需的）。
- **獲取絕對路徑**：注意，`ABSOLUTE_PATH` 可以通過在 Mac 的 `Finder` 中按 `CMD` 點擊文件來找到。

5. 驗證設置：打開 Cursor，此時應該會出現一個帶有 Slack 工具列表的 錘子圖標。此外，在 連接圖標 處也應該可以看到您的應用程序已連接到我們的 MCP。

💡 使用建議

• 在填寫環境變量時，請確保使用正確的 Paragon 資格信息，以免影響後續操作。
• 若您在獲取 ABSOLUTE_PATH 時遇到問題，可參考相關操作系統的文件路徑獲取方法。