Linear MCP Server

🚀 线性MCP服务器

线性MCP服务器是一个实现线性GraphQL API的MCP（模型上下文协议）服务器，它能让AI助手与线性项目管理系统进行交互，为项目管理提供了便捷的途径。

✨ 主要特性

• 可通过MCP工具访问线性GraphQL API。
• 支持使用线性API密钥进行身份验证。
• 能够获取和修改与用户、团队、项目和问题相关的数据。
• 可以创建、更新和评论问题。
• 支持添加和删除标签。
• 允许创建项目。
• 提供完整的工具文档。

📦 安装指南

通过Smithery

1. 访问Smithery网站并登录。
2. 在“添加服务器”部分找到线性MCP服务器。
3. 根据提示完成安装和配置。

手动安装

npm install --save @emmett-deen/linear-mcp-server

📚 详细文档

配置

创建一个.env文件并添加以下内容：

PORT=8080  # 可选，默认为3000
API_KEY=your_api_key_here

启动服务器

node index.js

先决条件

• Node.js版本12或更高
• npm版本6或更高
• 线性API密钥

安装说明

安装依赖项

npm install

运行服务器

node index.js --token your_api_token_here

在Claude Desktop上的配置

1. 打开Claude Desktop的设置。
2. 添加新的连接，选择线性MCP服务器作为提供商。
3. 输入服务器地址和API密钥。

示例用法

一旦与Claude Desktop连接，可以使用以下提示：

• “显示我所有的线性问题”
• “在前端团队创建一个新问题，标题为‘修复登录bug’”
• “将问题FE-123的状态更改为‘进行中’”
• “将问题BE-456指派给John Smith”
• “向问题UI-789添加评论：‘此问题需要在周五前解决’”

开发

设置开发环境

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev -- --token your_api_token_here

扩展服务器

1. 参考TOOLS.md文档中的实现指南。
2. 确保遵循src目录中的现有代码结构。
3. 更新文档以反映更改。

贡献和开发

设置开发环境

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev

发布到npm

1. 更新package.json中的版本：

npm version patch  # 或 minor，或 major

2. 构建项目：

npm run build

3. 确保已登录到npm：

npm login

4. 发布到npm：

npm publish --access public

5. 对于Smithery注册表，请与Smithery团队联系以获取服务器在目录中的列出。

💻 使用示例

基础用法

const { createIssue } = require('@emmett-deen/linear-mcp-server');

createIssue({
  title: '修复登录问题',
  description: '需要在周五前解决此问题。',
  assignee: 'john.smith@example.com',
  labels: ['bug', 'high-priority']
});

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。