Linear MCP Go

🚀 線性 MCP 服務器

這是一個用 Go 語言編寫的、用於線性（Linear）的模型上下文協議（MCP）服務器。它藉助 MCP 協議，提供了與線性 API 交互的工具，能幫助開發者更便捷地與線性平臺進行對接。

🚀 快速開始

創建 MCP 客戶端

使用以下代碼創建一個簡單的 MCP 客戶端：

package main

import (
	"log"
	"os"

	"github.com/yourusername/linear-mcp-server/pkg/client"
)

func main() {
	client := &client.Client{
		Token: os.Getenv("LINEAR_API_KEY"),
	}
	if err := client.Initialize(); err != nil {
		log.Fatalf("無法初始化客戶端：%v", err)
	}
	log.Println("客戶端已成功初始化")
}

✨ 主要特性

• 線性 MCP 服務器：允許通過 MCP 協議與線性平臺進行交互。
• 支持多種操作系統：生成適用於 Linux、macOS 和 Windows 的二進制文件。
• 自動化測試和發佈：使用 GitHub Actions 進行持續集成，自動執行測試和發佈流程。

📦 安裝指南

使用預編譯的二進制文件

1. 訪問 GitHub 發佈頁面。
2. 根據您的操作系統下載對應的二進制文件。
3. 解壓並運行：

# 例如，在 Linux 上：
tar -xzf linear-mcp-server-v1.0.0-linux-amd64.tar.gz
chmod +x linear-mcp-server
./linear-mcp-server

💻 使用示例

基礎用法

創建問題

package main

import (
	"log"
	"os"

	"github.com/yourusername/linear-mcp-server/pkg/client"
)

func main() {
	client := &client.Client{
		Token: os.Getenv("LINEAR_API_KEY"),
	}

	newIssue := &client.Issue{
		Title:   "新問題：測試 MCP 服務器",
		Description: "這是一個用於測試 MCP 服務器功能的示例問題。",
		Status:      "打開", // 狀態可以是："打開"、"進行中"或"已解決"
		Priority:    "高",   // 可以是："高"、"中"或"低"
	}

	if err := client.CreateIssue(newIssue); err != nil {
		log.Fatalf("創建問題時出錯：%v", err)
	}
	log.Println("問題已成功創建！")
}

📚 詳細文檔

線性 MCP 服務器功能

• 創建問題：通過 MCP 協議向線性平臺發送問題。
• 獲取問題：檢索特定問題的詳細信息。
• 更新問題：修改問題的狀態、標題或描述。
• 刪除問題：從線性平臺移除指定的問題。

🔧 技術細節

項目結構

linear-mcp-server/
├── go.mod
├── go.sum
├── main.go
├── pkg/
│   ├── client/
│   │   ├── client.go       # MCP 客戶端實現
│   │   └── types.go        # 自定義數據類型和結構體
└── README.md               # 項目文檔

🤝 貢獻指南

1. 克隆倉庫：git clone https://github.com/yourusername/linear-mcp-server.git
2. 安裝依賴：go mod tidy
3. 運行測試：

go test ./...

4. 提交更改：
   • 創建功能分支：git checkout -b feature/new-feature
   • 提交更改：git add . && git commit -m "添加新功能"
   • 推送到遠程倉庫：git push origin feature/new-feature

📄 許可證

本項目遵循 MIT 協議。