线性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文件。