Linear MCP 服务器

一个用于与 Linear 交互的模型上下文协议 (MCP) 服务器。该服务器允许 AI 助手通过 MCP 标准从 Linear 获取数据。

当前功能

• 通过用户 ID 或电子邮件地址获取用户的待办事项工单

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 在项目根目录创建一个 .env 文件（从 .env.example 复制）：

   LINEAR_API_KEY=your_linear_api_key_here
   

   从 Linear 开发者控制台 获取您的 Linear API 密钥

开发

运行开发服务器（带有热重载）：

npm run dev

构建用于生产环境

构建 TypeScript 代码：

npm run build

运行编译后的代码：

npm start

与 MCP 客户端一起使用

此 MCP 服务器实现了标准的 MCP 协议，可以与任何 MCP 客户端一起使用。该服务器公开了以下工具：

与 Claude Code 一起使用

要将此 MCP 服务器与 Claude Code 一起使用，请运行以下命令：

claude mcp add linear-mcp-server -- node dist/index.js

这会将 Linear MCP 服务器注册到 Claude Code，允许您直接从 Claude 对话中访问 Linear 工单。

get-user-todo-tickets

获取指定用户处于“Todo”状态的所有工单。

参数：

• userId (可选): 用户的 ID
• email (可选): 用户的电子邮件

注意：您必须提供 userId 或 email 中的一个。

示例响应：

[
  {
    "id": "issue-id",
    "identifier": "PROJ-123",
    "title": "修复登录问题",
    "url": "https://linear.app/...",
    "priority": 1
  },
  ...
]

贡献

欢迎贡献！请随时提交 pull request。