MCP Linear

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

功能

MCP Linear通过实现MCP协议，弥合了AI助手与Linear（项目管理工具）之间的鸿沟。这使得：

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

示例提示

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

• "显示我所有的Linear问题"
• "在Frontend团队中创建一个标题为'修复登录bug'的新问题"
• "将问题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文件。