Linear MCP Server 使用说明

项目简介

Linear MCP Server 是一个 Model Context Protocol (MCP) 服务器的实现，旨在桥接大型语言模型 (LLM) 与 Linear 项目管理工具。通过标准的 MCP 协议，它允许 LLM 客户端访问和操作 Linear 中的 issue、团队、组织等资源，并执行诸如创建 issue、搜索 issue 等操作，从而实现基于 LLM 的智能项目管理助手应用。

主要功能点

资源访问: 允许 LLM 读取 Linear 组织、团队和 issue 的信息。
工具调用: 提供创建 issue ('create-issue') 和搜索 issue ('search-issues') 的工具，以及读取指定资源 ('read-resource') 的通用工具。
Prompt 模板: 内置默认 Prompt 模板，指导 LLM 如何与 Linear MCP Server 交互。
速率限制: 实施每小时 1000 次请求的速率限制，并提供请求指标监控。
错误处理: 提供详细的错误信息，帮助开发者调试和排错。

安装步骤

克隆仓库:

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

安装依赖:
```
npm install
```
配置 Linear API 密钥:
- 创建 '.env' 文件在项目根目录。
- 在 '.env' 文件中添加你的 Linear API 密钥，例如：
```
LINEAR_API_KEY="YOUR_LINEAR_API_KEY"
```
  请替换 'YOUR_LINEAR_API_KEY' 为你实际的 Linear API 密钥。你可以在 Linear 设置页面获取 API 密钥。
启动服务器:
```
npm start
```
或者，你可以创建并运行 'linear.sh' 脚本（参考仓库 README.md），以便更灵活地配置环境变量和启动路径。

服务器配置

在 MCP 客户端（例如 Cursor）中配置 Linear MCP Server 时，你需要提供服务器启动命令。以下是一个典型的配置示例（JSON 格式）：

{
  "serverName": "LinearMCP",
  "command": "sh",
  "args": [
    "/absolute/path/to/linear-mcp-server/linear.sh" // 请替换为 linear.sh 脚本的绝对路径
  ]
}

配置参数说明:

'serverName': 服务器名称，可以自定义，例如 "LinearMCP"。
'command': 启动服务器的命令解释器，这里使用 'sh' (Shell)。
'args': 传递给命令解释器的参数列表，这里指定了 'linear.sh' 脚本的绝对路径。你需要将 '/absolute/path/to/linear-mcp-server/linear.sh' 替换为你机器上 'linear.sh' 脚本的实际绝对路径。

'linear.sh' 脚本示例 (内容):

export LINEAR_API_KEY="YOUR_LINEAR_API_KEY" # 请替换为你的 Linear API 密钥，也可以在 .env 文件中配置
node /absolute/path/to/linear-mcp-server/index.js # 请替换为 index.js 的绝对路径

注意:

请确保 'linear.sh' 脚本具有执行权限 ('chmod +x linear.sh')。
上述配置假设你使用 'linear.sh' 脚本启动服务器，你也可以直接使用 'node /absolute/path/to/linear-mcp-server/index.js' 作为 'command' 和 'args' 的配置，但推荐使用脚本方式以便更好地管理环境变量。
'/absolute/path/to/linear-mcp-server' 需要替换为你的 'linear-mcp-server' 仓库在你的文件系统中的绝对路径。

基本使用方法

配置完成后，在 MCP 客户端中，你可以通过自然语言指令或工具调用与 Linear MCP Server 交互。例如，你可以：

使用 'search-issues' 工具搜索 Linear issues，例如查询 "查找指派给我的高优先级 issue"。
使用 'create-issue' 工具创建新的 Linear issue，例如 "创建一个标题为 'Bug 反馈' 的 issue，指派给 '技术团队'"。
使用 'read-resource' 工具读取 Linear 资源信息，例如查询 "读取 issue 'issue-123' 的详细信息"。

具体的使用方式取决于你的 MCP 客户端的功能和界面。请参考你使用的 MCP 客户端的文档，了解如何配置和使用 MCP 服务器。

关键词