YouGile项目管理接口服务器

为YouGile项目管理平台提供API接口服务的MCP服务器,支持多种AI工具和开发环境集成。

  • by nebelov
  • TypeScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 nebelov/yougile-mcp

使用说明

@内贝洛夫/尤吉尔·麦克普

MCP服务器 尤吉尔 项目管理。 57工具 覆盖100%的YouGile API v2。

使用 克劳德, ChatGPT, Gemini CLI, VS代码, 光标,以及任何兼容MCP的客户端。

俄语自述/自述наруском


AI agent creates project, boards, columns, and tasks with rich descriptions — all via MCP

快速开始

自动设置(推荐)

npx @nebelov/yougile-mcp --setup

将您登录到YouGile,获得API密钥,并为您的人工智能工具编写配置。

手动设置

  1. 从YouGile获取API密钥(设置>API或 POST /auth/keys)
  2. 添加到您的AI工具配置中:

克劳德代码 (~/.claude.json):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

克劳德桌面 (claude_desktop_config.json):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

VS代码 (.vscode/mcp.json):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

ChatGPT设置

选项A:托管(推荐)

使用托管服务器 you-mcp.com --无需安装。

在ChatGPT(网络)中:

  1. 设置>应用程序和连接器>高级> 开发人员模式 开
  2. 点击 创建 >粘贴 https://you-mcp.com/mcp >保存
  3. 打开任何聊天>点击 + >更多>开发者模式>启用连接器
  4. ChatGPT将重定向您使用YouGile电子邮件和密码登录
  5. 您的凭据直接进入YouGile的API(零确认代理-服务器永远看不到您的密码)

选项B:自托管(ngrok)

需要 吸烟 (免费)。

步骤1。 使用HTTP传输启动服务器:

YOUGILE_API_KEY=your-key npx @nebelov/yougile-mcp --http --port 3000

步骤2。 在第二个终端中,创建HTTPS隧道:

ngrok http 3000

复制 https://...ngrok-free.app 来自ngrok输出的URL。

步骤3。 在ChatGPT(网络)中:

  1. 设置>应用程序和连接器>高级> 开发人员模式 开
  2. 点击 创建 >粘贴 https://YOUR-URL.ngrok-free.app/mcp >保存
  3. 打开任何聊天>点击 + >更多>开发者模式>启用连接器

可用工具(57)

模块 工具 说明
项目 4 列表、获取、创建、更新
boards 4 列表、获取、创建、更新
列 4 列表、获取、创建、更新
任务 6 列出、获取、创建、更新、获取/设置聊天订阅者
聊天 8 消息(列表、发送、获取、删除)+群聊(列表、获取、创建、更新)
用户 5 列表、获取、邀请、更新、删除
公司 2 获取、更新
部门 4 列表、获取、创建、更新
项目角色 5 列表、获取、创建、更新、删除
字符串贴纸 6 CRUD+创建/更新状态
冲刺贴纸 6 CRUD+创建/更新状态
webhook 3 列表、创建、更新

捆绑技能

该套餐包括 skill/SKILL.md --通过人工智能与YouGile合作的最佳实践指南。将其复制到您的项目或Claude Code技能目录中,以更好地进行任务管理。

API模式

  • 软删除: PUT {deleted: true} 适用于所有实体。 DELETE 该方法仅适用于项目角色。
  • 分页: {paging: {count, limit, offset, next}, content: [...]}.例外情况: /webhooks 返回原始数组。
  • 贴纸字段:使用 name (不是 title)用于贴纸和州。
  • 已分配任务:UUID数组 ["uuid1", "uuid2"],不是一个物体。
  • 聊天消息: PUT 仅支持 {deleted: true} --无法编辑文本。
  • 州ID:12个字符的十六进制字符串(不是UUID)。

环境变量

变量 必填 描述
YOUGILE_API_KEY 是 YouGile API密钥
YOUGILE_API_HOST_URL 否 自定义API URL(默认值: https://yougile.com/api-v2)

发展

git clone https://github.com/nebelov/yougile-mcp
cd yougile-mcp
npm install
npm run dev

许可证

麻省理工学院