Linear MCP 服务器

一个用于 Linear GraphQL API 的模型上下文协议 (MCP) 服务器实现，使 AI 助手能够与 Linear 项目管理系统交互。

功能

• 通过 MCP 工具访问 Linear 的 GraphQL API
• 通过 Linear API 密钥进行身份验证
• 检索和修改与用户、团队、项目和问题相关的数据
• 创建、更新和评论问题
• 添加和删除标签
• 创建项目
• 提供可用工具的全面文档

安装

通过 Smithery 安装（推荐）

要通过 Smithery 为 Claude Desktop 自动安装 Linear MCP 服务器：

npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

手动配置

安装后，将以下内容添加到您的 MCP 设置文件中：

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

客户端特定配置位置

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• GoMCP: ~/.config/gomcp/config.yaml

手动安装

1. 克隆存储库

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. 安装依赖项

npm install

3. 构建项目

npm run build

4. 创建一个包含您的 Linear API 令牌的 .env 文件

LINEAR_API_KEY=your_linear_api_key_here

5. 启动服务器

npm start

可用工具

有关可用工具和计划功能的完整列表，请参见 TOOLS.md。

概述

Linear-MCP-Server 通过实现 MCP 协议，弥合了 Claude（AI 助手）和 Linear（项目管理工具）之间的差距。这允许 Claude 执行以下操作：

• 从 Linear 检索问题、项目、团队和其他数据
• 创建和更新问题
• 更改问题状态
• 将问题分配给团队成员
• 添加评论
• 创建项目和团队

该服务器使用 Linear 的 GraphQL API，并通过用户令牌（而非 OAuth）进行身份验证，以简化操作。

入门

前提条件

• Node.js (v18+)
• NPM 或 Yarn
• Linear API 令牌

安装

# 全局安装
npm install -g @emmett.deen/linear-mcp-server

# 或克隆并在本地安装
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server
npm install
npm link  # 使软件包在全局范围内可用

运行服务器

使用您的 Linear API 令牌运行服务器：

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

或者在您的环境中设置令牌，并在没有参数的情况下运行：

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

与 Claude Desktop 一起使用

要将此 MCP 服务器与 Claude Desktop 一起使用：

1. 在 Claude Desktop 中启用开发者模式（从菜单栏）
2. 转到设置 > 开发者选项
3. 单击“添加服务器”
4. 使用以下设置进行配置：
   • 名称: Linear MCP Server
   • 类型: 本地进程
   • 命令: linear-mcp-server
   • 参数: --token YOUR_LINEAR_API_TOKEN

或者，手动编辑配置文件：

{
  "mcp": {
    "servers": [
      {
        "name": "Linear MCP Server",
        "transport": {
          "type": "stdio",
          "command": "linear-mcp-server",
          "args": ["--token", "YOUR_LINEAR_API_TOKEN"]
        }
      }
    ]
  }
}

5. 保存配置
6. 重新启动 Claude Desktop（完全退出并重新打开）
7. 您现在应该看到 Linear MCP Server 作为 Claude 中的一个可用工具

Claude 提示示例

连接到 Claude Desktop 后，您可以使用如下提示：

• "Show me all my Linear issues" (显示我所有的 Linear 问题)
• "Create a new issue titled 'Fix login bug' in the Frontend team" (在前端团队中创建一个名为“修复登录错误”的新问题)
• "Change the status of issue FE-123 to 'In Progress'" (将问题 FE-123 的状态更改为“进行中”)
• "Assign issue BE-456 to John Smith" (将问题 BE-456 分配给 John Smith)
• "Add a comment to issue UI-789: 'This needs to be fixed by Friday'" (向问题 UI-789 添加评论：“需要在周五之前修复”)

开发

要在本地进行开发：

# 克隆存储库
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

# 安装依赖项
npm install

# 在开发模式下运行
npm run dev -- --token YOUR_LINEAR_API_TOKEN

扩展服务器

要向服务器添加新工具：

1. 按照 TOOLS.md 文档中的实现指南进行操作
2. 确保遵循 src/ 目录中已建立的代码结构
3. 更新文档以反映您的更改

开发和贡献

设置开发环境

1. 克隆存储库

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. 安装依赖项

npm install

3. 在开发模式下启动

npm run dev

发布到 npm

要将此软件包发布到 npm：

1. 更新 package.json 中的版本

npm version patch  # 或 minor, 或 major

2. 构建项目

npm run build

3. 确保您已登录到 npm

npm login

4. 发布到 npm

npm publish --access public

5. 对于 Smithery 注册表，您需要与 Smithery 团队合作，以使您的服务器列在他们的目录中。

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。