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 协议。