AI导哈

Linear项目管理系统接口服务

Linear MCP Server是一个实现Model Context Protocol (MCP)的服务，通过GraphQL API连接AI助手与Linear项目管理系统，支持问题跟踪、项目管理和团队协作。

  • by wkoutre
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 wkoutre/linear-mcp-server

使用说明

线性MCP服务器

线性GraphQL API的模型上下文协议（MCP）服务器实现，使人工智能助手能够与线性项目管理系统交互。

特性

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

安装

通过Smithery安装（推荐）

要通过Smithery自动安装克劳德桌面的线性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"
      }
    }
  }
}

客户端特定配置位置

  • 克劳德桌面： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 克劳德VSCode扩展： ~/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
  1. 安装依赖项
npm install
  1. 构建项目
npm run build
  1. 创建一个 .env 使用您的Linear API令牌文件
LINEAR_API_KEY=your_linear_api_key_here
  1. 启动服务器
npm start

可用工具

看 TOOLS.md 查看可用工具和计划功能的完整列表。

概述

Linear MCP Server通过实施MCP协议弥合了Claude（人工智能助手）和Linear（项目管理工具）之间的差距。这使克劳德能够：

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

为了简单起见，服务器使用Linear的GraphQL API并通过用户令牌（而不是OAuth）进行身份验证。

入门指南

先决条件

  • Node.js（v18+）
  • NPM或纱线
  • 线性API令牌

安装

# Install globally
npm install -g @emmett.deen/linear-mcp-server

# Or clone and install locally
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server
npm install
npm link  # Makes the package available globally

运行服务器

使用您的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. 使用以下设置进行配置：
    • 名字：线性MCP服务器
    • 类型：本地流程
    • 命令：线性mcp服务器
    • 参数：--令牌YOUR_LINER_API_token

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

{
  "mcp": {
    "servers": [
      {
        "name": "Linear MCP Server",
        "transport": {
          "type": "stdio",
          "command": "linear-mcp-server",
          "args": ["--token", "YOUR_LINEAR_API_TOKEN"]
        }
      }
    ]
  }
}
  1. 保存配置
  2. 重新启动Claude Desktop（完全退出并重新打开）
  3. 现在，您应该可以在Claude中看到Linear MCP Server作为工具提供

克劳德提示示例

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

  • “显示我的所有线性问题”
  • “在前端团队中创建一个名为“修复登录错误”的新问题”
  • “将问题FE-123的状态更改为“进行中””
  • “将问题BE-456分配给约翰·史密斯”
  • “在UI-789问题上添加一条评论：‘这需要在周五之前解决’”

发展

在当地发展：

# Clone the repository
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

# Install dependencies
npm install

# Run in development mode
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
  1. 安装依赖项
npm install
  1. 以开发模式启动
npm run dev

发布到npm

要将此包发布到npm：

  1. 更新package.json中的版本
npm version patch  # or minor, or major
  1. 构建项目
npm run build
  1. 请确保您已经登录到npm
npm login
  1. 发布到npm
npm publish --access public
  1. 对于Smithery注册表，您需要与Smithery团队合作，将您的服务器列在他们的目录中。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP