🚀 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 搭建高效的服务器架构。
数据处理流程
- 请求接收与解析
- 参数校验
- 业务逻辑执行
- 结果包装与返回
错误处理机制
异常捕捉
- 网络错误检测
- HTTP 状态码处理
- 详细错误日志记录
全局中间件
用于统一处理所有 API 请求和响应，确保系统稳定性。
📄 许可证
本项目遵循 MIT 许可证协议。更多详情请参阅 LICENSE 文件。