Linear MCP Server

Linear MCP Server

site icon
2025.02.11 1
JavaScript项目管理团队协作交流协作
Linear MCP Server 是一个实现了 Linear Model Context Protocol (MCP) 的服务,提供了访问 Linear 资源的接口。它允许用户通过 MCP 接口创建、搜索和管理 Linear 的问题(issues),以及读取团队和组织资源。该服务适用于需要集成 Linear 项目管理工具的开发团队,提供了丰富的 API 功能和错误处理机制。
View on GitHub

Overview

基本能力

产品定位

Linear MCP Server 是一个为 Linear 项目管理工具提供 MCP 接口的服务,旨在简化开发团队对 Linear 资源的访问和管理。

核心功能

  1. 创建问题(create-issue):支持创建新的 Linear 问题,包括标题、团队 ID、描述、优先级、状态 ID、分配者 ID、预估时间和标签 ID 等参数。
  2. 搜索问题(search-issues):支持通过查询字符串搜索 Linear 问题,支持多种过滤器,如分配者、优先级、状态、团队和标签等。
  3. 读取资源(read-resource):支持通过 URI 读取 Linear 资源,包括组织详情、问题列表、特定问题详情、团队列表和特定团队详情。
  4. 速率限制:实现了每小时 1000 次请求的限制,并自动跟踪请求和提供指标。
  5. 错误处理:提供详细的错误消息,包括 Linear API 错误、速率限制超出、无效资源类型和认证问题等。

适用场景

  1. 开发团队集成:开发团队可以通过该服务将 Linear 项目管理工具集成到自己的开发流程中。
  2. 自动化任务:支持通过 API 自动化创建和搜索问题,提高团队效率。
  3. 资源管理:方便读取和管理团队和组织资源。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 克隆仓库并安装依赖:
git clone [email protected]:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

安装教程

  1. 创建启动脚本:
touch linear.sh
chmod +x linear.sh
  1. 在脚本中添加以下内容(替换为你的 Linear API 密钥和绝对路径):
export LINEAR_API_KEY="<YOUR LINEAR API KEY>"
node /absolute/path/to/linear-mcp-server/index.js
  1. 在 Cursor 中配置:
  2. 打开 Cursor 设置。
  3. 在 MCP Server 部分添加新服务器。
  4. 选择类型:Command
  5. 设置命令:sh /absolute/path/to/linear.sh
  6. 启动服务器:
npm start

调试方式

  1. 确保服务器已启动并运行。
  2. 使用提供的工具(如 create-issuesearch-issuesread-resource)进行测试。
  3. 检查错误消息和速率限制指标以进行调试。

许可证

None