MCP Linear

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

功能

MCP Linear 通过实现 MCP 协议来弥合 AI 助手与 Linear（项目管理工具）之间的差距。这允许：

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

示例提示

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

• "显示我所有的 Linear 问题"
• "在前端团队中创建一个标题为 '修复登录错误' 的新问题"
• "将问题 FE-123 的状态更改为 '进行中'"
• "将问题 BE-456 分配给 John Smith"
• "向问题 UI-789 添加评论：'这个问题需要在周五前解决'"

安装

获取您的 Linear API 令牌

要使用 MCP Linear，您需要一个 Linear API 令牌。获取方法如下：

1. 登录到您的 Linear 账户 linear.app
2. 点击组织头像（位于左上角）
3. 选择 设置
4. 在左侧边栏中导航至 安全与访问
5. 在 个人 API 密钥 下点击 新 API 密钥
6. 给您的密钥命名（例如，MCP Linear 集成）
7. 复制生成的 API 令牌并安全存储 - 您将无法再次查看它！

通过 Smithery 安装（推荐）

• 为 Cursor 安装 MCP Linear：

npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor

• 为 Claude Desktop 安装 MCP Linear：

npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude

手动配置

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

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@tacticlaunch/mcp-linear"],
      "env": {
        "LINEAR_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

客户端特定配置位置

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

手动运行

先决条件

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

# Install globally
npm install -g @tacticlaunch/mcp-linear

# Or clone and install locally
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link  # Makes the package available globally

运行服务器

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

mcp-linear --token YOUR_LINEAR_API_TOKEN

或者在环境中设置令牌然后不带参数运行：

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear

可用工具

请参阅 TOOLS.md 以获取完整的可用工具列表及计划中的功能。

开发

请参阅DEVELOPMENT.md以获取有关如何进行本地开发的更多信息。

许可证

本项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。