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

示例工具

创建问题

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

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

📚 详细文档

线性MCP服务器允许AI助手与线性项目管理系统无缝交互。通过集成MCP协议，用户可以轻松管理项目、任务和团队成员。

先决条件

• 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团队联系以获取服务器在目录中的列出。

📄 许可证

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