Linear

🚀 线性 MCP 服务器

这是一个用于与线性（Linear）交互的 Model Context Protocol (MCP) 服务器。该服务器允许 AI 助手通过 MCP 标准从线性获取数据，为开发者提供了便捷的数据交互方式。

🚀 快速开始

此线性 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
},
...
]

🤝 贡献指南

欢迎贡献！请随意提交拉取请求，一起让这个项目变得更完善。