Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个专门用于与 Linear 问题跟踪系统集成的 MCP 服务，旨在通过 MCP 协议实现 LLMs 与 Linear 问题的交互。

核心功能

1. 问题管理：支持创建、更新、搜索 Linear 问题。
2. 用户问题获取：可以获取分配给特定用户的问题。
3. 评论功能：支持在问题上添加评论。
4. 资源访问：提供多种资源 URI 用于查看问题、团队问题、用户分配问题等。

适用场景

1. 团队协作：帮助团队成员通过 LLMs 快速创建、更新和跟踪问题。
2. 项目管理：通过搜索和过滤功能，快速获取项目中的问题状态。
3. 自动化报告：自动生成问题报告或更新问题状态。

工具列表

1. linear_create_issue：创建新的 Linear 问题。
2. 必需输入：title（标题）、teamId（团队 ID）。
3. 可选输入：description（描述）、priority（优先级）、status（状态）。
4. linear_update_issue：更新现有问题。
5. 必需输入：id（问题 ID）。
6. 可选输入：title、description、priority、status。
7. linear_search_issues：搜索问题。
8. 可选输入：query（查询文本）、teamId、status、assigneeId、labels、priority、limit。
9. linear_get_user_issues：获取分配给用户的问题。
10. 可选输入：userId（用户 ID）、includeArchived（包括已归档问题）、limit（最大结果数）。
11. linear_add_comment：在问题上添加评论。
12. 必需输入：issueId（问题 ID）、body（评论内容）。
13. 可选输入：createAsUser（自定义用户名）、displayIconUrl（自定义头像 URL）。

常见问题解答

1. 如何获取 Linear API 密钥？
2. 访问 Linear API 设置页面 创建或获取 API 密钥。
3. 如何配置 Claude Desktop 以使用此服务？
4. 修改 claude_desktop_config.json 文件，添加 mcpServers 配置。

使用教程

使用依赖

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

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --client claude

手动安装

1. 获取 Linear API 密钥。
2. 配置 Claude Desktop 的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

调试方式

1. 安装依赖：

npm install

1. 配置 .env 文件：

LINEAR_API_KEY=your_api_key_here

1. 构建服务器：

npm run build

1. 开发模式（自动重建）：

npm run watch

许可证

该项目遵循 MIT 开源许可条款。