项目与问题管理服务器

线性MCP服务器

一种模型上下文协议（MCP）服务器，可与Linear无缝集成，用于项目和问题管理。

🚀 特性

项目管理

• ✅ 创建项目 -使用自定义名称、描述、优先级和内容创建新的线性项目
• ✅ 列出项目 -获取工作区中所有项目的详细信息
• ✅ 查看项目详细信息 -检索有关特定项目的全面信息
• ✅ 删除项目 -从工作区中删除项目

问题管理

• ✅ 创建问题 -使用标题、描述、优先级和项目分配创建新问题
• ✅ 列出问题 -查看分配给您的所有问题
• ✅ 删除问题 -从工作区中删除问题
• ✅ 自动分配 -问题会自动分配给当前用户

团队和用户管理

• ✅ 获取团队信息 -查看有关线性团队的信息
• ✅ 获取当前用户 -显示已验证用户的信息
• ✅ 默认团队 -自动使用默认团队进行操作

🛠️ 可用工具

项目工具

• create-project -创建新的线性项目
• get-all-project -列出所有项目
• view-project-detail -获取详细的项目信息
• delete-project -按ID删除项目

问题工具

• create-issue -创建新问题
• get-all-issues -列出所有分配的问题
• delete-issue -按ID删除问题

团队和用户工具

• get-team-info -获取团队信息
• current-user -获取当前用户信息

📋 先决条件

• Node.js（v16或更高版本）
• npm或纱线
• 线性API键

🔧 安装

1. 克隆存储库：

git clone https://github.com/TechAIInsights/linear-mcp-server.git
cd linear-mcp-server

2. 安装依赖项：

npm install

3. 设置环境变量：

# Create a .env file
echo "LINEAR_API_KEY=your_linear_api_key_here" > .env

4. 获取您的Linear API密钥：
   • 首选 线性设置>API
   • 生成新的API密钥
   • 将其添加到您的 .env 文件

🚀 用法

发展模式

npm run dev

生产建设

npm run build
npm start

📁 添加服务器配置

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/repo/dist/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

💡 使用示例

创建项目

# Create a project with basic info
create-project "My New Project"

# Create a project with full details
create-project "Advanced Project" --description "A complex project" --priority "high" --content "Project details here"

创建问题

# Create a basic issue
create-issue "Fix authentication bug"

# Create an issue with priority and project
create-issue "Implement new feature" --priority 2 --projectId "proj_123"

管理项目

# List all projects
get-all-project

# View project details
view-project-detail --id "proj_123"

# Delete a project
delete-project --id "proj_123"

🔧 配置

环境变量

• LINEAR_API_KEY -您的Linear API密钥（必需）

优先级

• 0 -无优先级
• 1 -紧急
• 2 -高
• 3 -正常
• 4 -低

🏗️ 建筑

服务器采用模块化架构构建，以实现可维护性：

• 模块化工具 -每个工具类别都有自己的模块
• 标准化响应 -所有工具的一致响应格式
• 错误处理 -使用上下文感知消息进行全面的错误处理
• 类型安全 -具有正确类型定义的完全TypeScript支持

📚 开发脚本

• npm run build -将TypeScript编译为JavaScript
• npm run start -运行已编译的应用程序
• npm run dev -热重载运行（HMR）
• npm run dev:watch -使用TypeScript编译+nodemon运行
• npm run watch -注意更改并自动重新编译
• npm run test -使用Jest运行测试
• npm run clean -删除已编译的输出

🔗 相关

• 线性API文档
• 模型上下文协议
• TypeScript