<p align="center"> <img src="https://github.com/tacticlaunch/mcp-linear/blob/main/docs/linear-app-icon.png?raw=true" alt="Linear 应用图标" width="250" height="250"> </p>

MCP Linear

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

<a href="https://glama.ai/mcp/servers/@tacticlaunch/mcp-linear"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=4042567526,3096290317&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

功能

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令牌

# 全局安装
npm install -g @tacticlaunch/mcp-linear

# 或者克隆并本地安装
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link  # 使包全局可用

运行服务器

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

mcp-linear --token YOUR_LINEAR_API_TOKEN

或者在环境中设置令牌并无需参数运行：

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear

可用工具

参见 TOOLS.md 以获取完整的可用工具和计划功能列表。

开发

参见 DEVELOPMENT.md 以了解如何本地开发的更多信息。

链接

tacticlaunch/cursor-memory-bank - 如果您是希望使用Cursor增强工作流程的开发者，请考虑试用一下。

许可证

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