线性 MCP 服务器

这是一个用于与线性（Linear）交互的 Model Context Protocol (MCP) 服务器。该服务器允许 AI 助手通过 MCP 标准从线性获取数据。

当前功能

• 获取指定用户的待办事项票证，可通过用户 ID 或电子邮件地址进行查询

安装指南

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

   npm install
   

3. 在项目根目录创建一个 .env 文件（基于 .env.example 模板）：

   LINEAR_API_KEY=你的线性API密钥
   

   从 线性开发者控制台 获取你的线性 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

这会将线性 MCP 服务器注册到 Claude Code，使你能够直接从 Claude 对话中访问线性票证。

获取用户待办事项票证

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

参数：

• userId（可选）：用户的 ID
• email（可选）：用户的电子邮件地址

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

示例响应：

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

贡献指南

欢迎贡献！请随意提交拉取请求。