Linear MCP 服务器

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

功能

• 资源: 访问 issue、项目、团队、用户、路线图、文档、计划等等
• 工具: 创建和更新 issue、管理项目、搜索、将项目链接到计划
• 提示: 用于创建 issue、错误报告、功能请求等的模板

设置

前提条件

• 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 的 CLI 工具):

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 中，转到 Settings → Advanced → MCP Configuration。

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 实体作为资源的访问：

核心资源

• Issues: linear://issues 和 linear://issues/{id}
• Teams: linear://teams 和 linear://teams/{id}
• Projects: linear://projects 和 linear://projects/{id}
• Users: linear://users 和 linear://users/{id}
• Initiatives: linear://initiatives 和 linear://initiatives/{id}

附加资源

• Roadmaps: linear://roadmaps 和 linear://roadmaps/{id}
• Milestones: linear://milestones 和 linear://milestones/{id}
• Documents: linear://documents 和 linear://documents/{id}
• Integrations: linear://integrations 和 linear://integrations/{id}
• Organization: linear://organization

特殊资源

• linear://teams/{teamId}/issues - 特定团队的 Issues
• linear://users/{userId}/issues - 分配给特定用户的 Issues
• linear://projects/{projectId}/issues - 特定项目中的 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 - 可用的集成服务

工具

该服务器提供以下工具：

• Issue 管理

  • 创建新的 issue
  • 更新现有的 issue
  • 向 issue 添加评论

• 项目管理

  • 创建新的项目
  • 更新现有的项目
  • 将 issue 添加到项目

• 计划管理

  • 创建计划
  • 将项目链接到计划
  • 从计划中取消链接项目

• 搜索功能

  • 跨 Linear 实体的全面搜索
  • 查找具有特定标准的 issue

提示

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

• Issue 相关

  • 创建新的 issue
  • 创建错误报告
  • 创建功能请求

• 项目相关

  • 创建新的项目
  • 使用 issue 规划项目
  • 创建项目状态更新

测试

使用 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