Linear MCP Server

Linear MCP 服务

一个适用于 Linear 的模型上下文协议（MCP）服务，为 AI 助手提供访问 Linear 项目管理功能的能力。

功能

• 资源： 访问问题、项目、团队、用户、路线图、文档、计划等
• 工具： 创建和更新问题、管理项目、搜索、将项目关联到计划
• 提示词： 用于创建问题、提交 Bug 报告、提出功能请求等的模板

设置

先决条件

• Node.js 18 或更高版本
• Linear API 密钥

安装

1. 克隆代码仓库：

   git clone https://github.com/yourusername/linear-mcp.git
   cd linear-mcp
   

2. 安装依赖：

   npm install
   

3. 创建一个包含 Linear API 密钥的 .env 文件：

   LINEAR_API_KEY=your_linear_api_key_here
   

4. 构建项目：

   npm run build
   

使用方法

命令行（stdio）

使用 stdio 传输运行服务（适用于支持 MCP 的命令行工具）：

npm start

或者：

node dist/index.js stdio

HTTP 服务（用于远程连接）

将服务作为支持服务器发送事件（SSE）的 HTTP 服务运行：

node dist/index.js http

这将在 3000 端口启动 HTTP 服务（可通过 PORT 环境变量配置）。

开发模式

在开发模式下运行并启用自动重新加载：

npm run dev

Claude Desktop 集成

要将此服务与 Claude Desktop 配合使用：

1. 构建项目：

   npm run build
   

2. 在 Claude Desktop 中，前往设置 → 高级 → MCP 配置。

3. 添加以下配置（调整路径以匹配你的安装位置）：

   {
     "mcpServers": {
       "linear": {
         "command": "node",
         "args": [
           "/path/to/linear-mcp/dist/index.js"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

4. 保存配置并重启 Claude Desktop。

或者，你可以复制提供的 claude-desktop-config.json 文件，并修改路径以匹配你的安装位置。

资源

该服务以资源的形式提供对所有主要 Linear 实体的访问：

核心资源

• 问题： linear://issues 和 linear://issues/{id}
• 团队： linear://teams 和 linear://teams/{id}
• 项目： linear://projects 和 linear://projects/{id}
• 用户： linear://users 和 linear://users/{id}
• 计划： linear://initiatives 和 linear://initiatives/{id}

其他资源

• 路线图： linear://roadmaps 和 linear://roadmaps/{id}
• 里程碑： linear://milestones 和 linear://milestones/{id}
• 文档： linear://documents 和 linear://documents/{id}
• 集成： linear://integrations 和 linear://integrations/{id}
• 组织： linear://organization

专用资源

• linear://teams/{teamId}/issues - 特定团队的问题
• linear://users/{userId}/issues - 分配给特定用户的问题
• linear://projects/{projectId}/issues - 特定项目中的问题
• linear://teams/{teamId}/states - 团队的工作流状态
• linear://teams/{teamId}/labels - 团队的标签
• linear://teams/{teamId}/cycles - 团队的周期
• linear://teams/{teamId}/members - 团队成员
• linear://teams/{teamId}/documents - 团队的文档
• linear://projects/{projectId}/documents - 项目的文档
• linear://projects/{projectId}/initiative - 与项目关联的计划
• linear://initiatives/{initiativeId}/projects - 与计划关联的项目
• linear://milestones/{milestoneId}/projects - 里程碑对应的项目
• linear://organization/subscription - 组织订阅详情
• linear://organization/auth-services - 组织身份验证服务
• linear://integration-services - 可用的集成服务

工具

该服务提供以下工具：

• 问题管理

  • 创建新问题
  • 更新现有问题
  • 为问题添加评论

• 项目管理

  • 创建新项目
  • 更新现有项目
  • 将问题添加到项目

• 计划管理

  • 创建计划
  • 将项目关联到计划
  • 取消项目与计划的关联

• 搜索功能

  • 全面搜索 Linear 中的各类实体
  • 按特定条件查找问题

提示词

该服务提供以下提示词模板：

• 问题相关

  • 创建新问题
  • 创建错误报告
  • 创建功能请求

• 项目相关

  • 创建新项目
  • 使用问题规划项目
  • 创建项目状态更新

测试

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector stdio -- npm start

或者，如果以 HTTP 模式运行，请在浏览器中打开 MCP Inspector，并连接到服务的 URL。

环境变量

• LINEAR_API_KEY（必需）：你的 Linear API 密钥
• SERVER_PORT（可选）：HTTP 服务的端口（默认值：3000）
• LOG_LEVEL（可选）：日志级别（默认值：info）

许可证

MIT