关键词

GitLab集成Asana集成任务管理代码仓库AI助手工具

项目简介

Assistant MCP Server 是一个实现了 Model Context Protocol (MCP) 的后端服务。它通过 MCP 协议向支持该协议的 LLM 客户端提供一系列工具，用于与外部服务（如 GitLab 和 Asana）进行交互，获取上下文信息或执行操作。

主要功能点

  • GitLab 集成: 提供搜索 GitLab 项目的工具。
  • Asana 集成: 提供获取用户信息、搜索个人任务以及搜索所有任务的工具。
  • 架构信息获取: 提供获取特定 GitLab 项目中架构文档内容的工具。
  • 标准协议通信: 通过 JSON-RPC 和 Stdio 传输协议与 MCP 客户端通信。

安装步骤

  1. 克隆仓库: 
    git clone https://github.com/nodlab/mcp-assistant.git
cd mcp-assistant
  2. 安装依赖: 确保已安装 Node.js 和 npm 或 yarn。 
    npm install
# 或 yarn install
  3. 配置环境变量: 创建 '.env' 文件，配置访问 GitLab 和 Asana 所需的 API 密钥和 URL。 
    GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_personal_access_token
GITLAB_API_URL=https://gitlab.com/api/v4
ASANA_ACCESS_TOKEN=your_asana_access_token
ASANA_API_URL=https://app.asana.com/api/1.0
    请替换 'your_gitlab_personal_access_token' 和 'your_asana_access_token' 为您自己的凭证。'GITLAB_API_URL' 和 'ASANA_API_URL' 根据您的实际部署情况可能需要调整。

服务器配置

要在支持 MCP 协议的客户端中使用此服务器，您需要在客户端中添加 MCP 服务器配置。此服务器使用 'stdio' 传输协议运行，通过执行一个命令启动。

通常，客户端配置会是一个 JSON 对象，包含服务器名称、启动命令及其参数。对于 Assistant MCP Server，配置信息如下：

{
  "name": "assistant-mcp-server",
  "command": "node",
  "args": ["index.js"],
  // 您还需要确保运行此命令的环境中配置了 .env 文件中的环境变量
  // 或通过客户端的配置方式传入这些环境变量
  // (具体如何配置环境变量取决于您的 MCP 客户端实现)
}
  • 'name': 服务器的唯一名称，此处为 "assistant-mcp-server"。
  • 'command': 启动服务器进程的命令，此处为 "node"。
  • 'args': 传递给命令的参数，此处为要执行的主脚本文件 "index.js"（请确保项目已构建，'index.ts' 被编译为 'index.js'）。

重要提示: 在客户端运行服务器命令之前，请确保您的系统已安装 Node.js，并且运行命令的环境中已正确设置 'GITLAB_PERSONAL_ACCESS_TOKEN', 'ASANA_ACCESS_TOKEN' 等环境变量。

基本使用方法

  1. 完成安装和配置步骤。
  2. 在您的 MCP 客户端中添加并启用 Assistant MCP Server 配置。
  3. 您的 LLM 客户端现在应该能够通过 MCP 协议发现并调用此服务器提供的工具，例如 'search_repositories'、'search_my_tasks' 等。
  4. LLM 可以根据用户的请求，调用相应的工具并传递必要的参数（例如搜索关键字、用户 ID 等），服务器将执行对应的操作（如调用 GitLab/Asana API）并将结果返回给 LLM。

信息

分类

开发者工具

访问项目