MCP Server Linear

🚀 mcp-server-linear

mcp-server-linear是一個與Linear API交互的模型上下文協議（MCP）服務器。它通過標準化的MCP接口，提供了訪問和操作Linear問題、項目及其他數據的工具和資源，為客戶端應用程序與Linear之間搭建了便捷的橋樑。

🚀 快速開始

mcp-server-linear項目作為客戶端應用程序（特別是AI助手和其他工具）與Linear之間的橋樑，提供了對Linear資源的標準化接口訪問。以下是快速啟動該項目的步驟：

1. 安裝依賴：通過pnpm安裝項目所需依賴。

pnpm install

2. 啟動服務器：啟動MCP服務器。

pnpm run start

✨ 主要特性

• 標準訪問：提供對Linear資源（問題、項目、舉措、團隊）的標準訪問。
• CRUD操作：支持問題和評論的完整CRUD操作。
• 篩選搜索：具備問題的高級篩選和搜索功能。
• 錯誤處理：擁有一致的錯誤處理和響應格式。
• 集成能力：可與AI助手通過MCP協議集成。

📦 安裝指南

安裝依賴

通過pnpm安裝項目依賴：

pnpm install

啟動服務器

啟動MCP服務器：

pnpm run start

配置選項

環境變量

• LINEAR_API_KEY：必需的環境變量，用於身份驗證。
• PORT：可選，默認為3000。指定服務器運行的端口。

身份驗證

此服務器支持兩種身份驗證方式：

1. API密鑰認證

在環境中設置LINEAR_API_KEY變量。例如：

LINEAR_API_KEY=your_api_key_here pnpm run start

2. OAuth認證

配置 OAuth 客戶端並使用獲取的訪問令牌進行身份驗證。

💻 使用示例

操作命令

# 啟動服務器（包含調試模式）
pnpm run start -- --debug

# 定義日誌文件路徑
pnpm run start -- --log-file custom.log

MCP監察工具

使用MCP監察工具與服務器交互：

1. 全局安裝MCP監察工具：

pnpm install -g @modelcontextprotocol/inspector

2. 使用npx啟動監察工具：

LINEAR_API_KEY=your_api_key_here npx -y @modelcontextprotocol/inspector @mkusaka/mcp-server-linear

🔧 技術細節

此服務器遵循模型上下文協議（MCP）架構，提供標準化方式訪問Linear資源。關鍵架構決策包括：

1. 資源組織：按領域將資源組織在單獨的文件中。
2. 錯誤處理：所有資源的一致錯誤處理。
3. 響應格式：一致的JSON響應格式。

有關詳細信息，請參閱adr.md。

📚 詳細文檔

開發命令

# 運行測試
pnpm test

# 構建項目
pnpm run build

# 監視更改
pnpm run watch

# 以調試模式運行
pnpm run debug

📄 許可證

本項目採用MIT許可證。

🤝 貢獻

歡迎貢獻！請參考adr.md瞭解架構決策和項目結構。