🚀 Linear MCP 服务器

Linear MCP 服务器整合了 Linear 的官方 SDK 和 MCP 协议，具备类型安全、高效性能等特点，能为开发者提供稳定且强大的服务。

🚀 快速开始

要使用此项目，请确保安装了以下依赖：

bun add @linear/sdk @modelcontextprotocol/sdk

启动服务器前，配置环境变量 NEXT_PUBLIC_LINEAR_SDK_CONFIG。

{
  "url": "https://app.linear.app",
  "authType": "token"
}

然后运行：

bun dev

✨ 主要特性

• 类型安全：所有接口和方法均使用 TypeScript 定义，确保代码的类型安全性。
• 高效性能：基于 Bun 运行时环境构建，提供卓越的执行效率。
• 集成开发工具包：整合了 Linear 的官方 SDK 和 MCP 协议 1.4.0 版本。

📦 安装指南

安装依赖

bun add @linear/sdk @modelcontextprotocol/sdk

启动服务器

启动前需配置环境变量 NEXT_PUBLIC_LINEAR_SDK_CONFIG：

{
  "url": "https://app.linear.app",
  "authType": "token"
}

之后运行启动命令：

bun dev

📚 详细文档

配置参数

环境变量

• NEXT_PUBLIC_BASE_URL：设置为你的 Linear 基础 URL，默认是 https://app.linear.app。
• NEXT_PUBLIC_WEB_BASE_URL：设置为你的 Web 应用程序的公开 URL。

其他配置

在 .env 文件中添加以下内容：

NEXT_PUBLIC_LINEAR_SDK_CONFIG=url=https://app.linear.app&authType=token

使用说明

快速入门

import { type Context } from '@modelcontextprotocol/sdk'

export async function getContext(): Promise<Context> {
  const config = new Configuration()
  const client = new LinearClient(config)
  return await client.getContext()
}

高级功能

团队管理

• 获取所有团队：GET /api/teams
• 搜索特定团队：支持按名称或键过滤

项目操作

• 列出所有项目：GET /api/projects
• 创建新项目：POST /api/projects

🔧 技术细节

架构组件

• 前端界面：使用 React 和 Tailwind CSS 实现响应式设计。
• 后端逻辑：基于 Bun 搭建高效的服务器架构。

数据处理流程

1. 请求接收与解析
2. 参数校验
3. 业务逻辑执行
4. 结果包装与返回

错误处理机制

异常捕捉

• 网络错误检测
• HTTP 状态码处理
• 详细错误日志记录

全局中间件

用于统一处理所有 API 请求和响应，确保系统稳定性。

📄 许可证

本项目遵循 MIT 许可证协议。更多详情请参阅 LICENSE 文件。