🚀 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 时遇到问题，可参考相关操作系统的文件路径获取方法。