使用说明

项目简介

Composio MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器端应用,旨在为大型语言模型 (LLM) 提供与 Composio 应用(如 Gmail、Linear 等)集成的能力。通过此服务器,LLM 可以利用 Composio 提供的工具来访问和操作各种在线服务,从而扩展 LLM 的功能边界。

主要功能点

  • 工具注册与执行: 将 Composio 应用的功能封装为 MCP 工具,例如读取邮件、创建任务等,并允许 LLM 通过标准化的 MCP 协议调用这些工具。
  • Composio 应用集成: 支持集成多种 Composio 应用,如 Gmail、Linear 等,未来可能扩展支持更多应用。
  • 标准化 MCP 接口: 遵循 MCP 协议规范,提供与 MCP 客户端(如 Cursor 编辑器等)的无缝对接能力。
  • Stdio 传输协议: 使用标准输入输出 (Stdio) 作为默认的 MCP 服务器传输协议,方便部署和集成。

安装步骤

  1. 克隆仓库

    git clone https://github.com/MCP-Mirror/ComposioHQ_composio-mcp-server.git
    cd ComposioHQ_composio-mcp-server
  2. 安装依赖 确保已安装 Node.js (16 或更高版本) 和 pnpm。

    pnpm install
  3. 构建项目

    pnpm build
  4. 运行服务器 启动服务器前,需要设置 Composio API 密钥和要启用的 Composio 应用。您可以通过访问 https://app.composio.dev 注册获取 API 密钥。

    env COMPOSIO_API_KEY=<your_composio_api_key> env COMPOSIO_APPS=gmail,linear node build/index.js

    将 '<your_composio_api_key>' 替换为您的 Composio API 密钥。'COMPOSIO_APPS' 环境变量指定要启用的 Composio 应用,多个应用之间用逗号分隔。

服务器配置

对于 MCP 客户端(例如 Cursor 编辑器),您需要配置 MCP 服务器的启动命令。以下是配置示例(JSON 格式):

{
  "servers": [
    {
      "name": "composio-mcp-server",
      "command": "env",
      "args": [
        "COMPOSIO_API_KEY=<your_composio_api_key>",
        "COMPOSIO_APPS=gmail,linear",
        "node",
        "/path/to/ComposioHQ_composio-mcp-server/build/index.js"
      ],
      "languages": [],
      "蓼": {}
    }
  ]
}

配置参数说明:

  • 'name': 服务器名称,可以自定义,例如 "composio-mcp-server"。
  • 'command': 启动服务器的命令,这里使用 'env' 命令来设置环境变量。
  • 'args': 命令参数列表,包括:
    • '"COMPOSIO_API_KEY=<your_composio_api_key>"': 设置 Composio API 密钥,请替换为您的实际密钥。
    • '"COMPOSIO_APPS=gmail,linear"': 指定要启用的 Composio 应用,可以根据需要修改。
    • '"node"': 使用 Node.js 运行程序。
    • '"/path/to/ComposioHQ_composio-mcp-server/build/index.js"': Composio MCP Server 构建后的入口文件路径,请替换为您的实际路径。
  • 'languages': 指定服务器支持的编程语言,留空表示支持所有语言。
  • '蓼': 其他配置项,通常为空对象。

注意: 请将 '<your_composio_api_key>' 替换为您的 Composio API 密钥,并将 '"/path/to/ComposioHQ_composio-mcp-server"' 替换为克隆仓库后 'ComposioHQ_composio-mcp-server' 文件夹在您本地文件系统中的绝对路径。

基本使用方法

  1. 确保 Composio MCP Server 已成功启动并运行。
  2. 在 MCP 客户端(如 Cursor 编辑器)中配置并连接到 Composio MCP Server。
  3. 在 MCP 客户端中,LLM 即可发现并调用 Composio MCP Server 提供的工具,例如操作 Gmail 或 Linear 应用的功能。 具体工具的使用方法和参数,请参考 Composio 官方文档或工具的描述信息。

信息

分类

生产力应用