Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个用于访问和管理 Linear 资源的 MCP 协议实现，主要面向开发团队和项目管理人员，提供与 Linear 项目管理系统集成的能力。

核心功能

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

适用场景

1. 开发团队集成：开发团队可以将 Linear MCP Server 集成到其开发流程中，自动化创建和管理问题。
2. 项目管理：项目管理人员可以通过该服务快速搜索和查看项目中的问题，提高管理效率。
3. 资源监控：通过读取资源功能，可以监控组织、团队和问题的状态，便于资源分配和进度跟踪。

工具列表

1. create-issue：创建新的 Linear 问题，支持多种参数配置。
2. search-issues：搜索 Linear 问题，支持多种过滤器和自由文本搜索。
3. read-resource：读取 Linear 资源，包括组织、问题和团队等。

常见问题解答

1. 如何获取 Linear API 密钥：可以从 Linear 设置页面 获取 API 密钥。
2. 速率限制：服务实现了每小时 1000 次请求的速率限制，超出限制会返回错误。
3. 错误处理：服务会返回详细的错误消息，帮助用户快速定位和解决问题。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 确保已安装 Git。

安装教程

1. 克隆仓库并安装依赖：

git clone [email protected]:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

1. 创建启动脚本：

touch linear.sh
chmod +x linear.sh

1. 在脚本中添加以下内容：

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-issue、search-issues、read-resource）进行测试。
3. 检查返回的响应和错误消息，确保功能正常。

许可证

None