Linear MCP Go

🚀 Linear MCP Server

This is a Model Context Protocol (MCP) server for Linear, written in Go. The server provides tools for interacting with the Linear API through the MCP protocol.

🚀 Quick Start

Create an MCP Client

Use the following code to create a simple MCP client:

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("Failed to initialize client: %v", err)
	}
	log.Println("Client initialized successfully")
}

✨ Features

• Linear MCP Server: Allows interaction with the Linear platform via the MCP protocol.
• Multi - OS Support: Generates binary files for Linux, macOS, and Windows.
• Automated Testing and Release: Uses GitHub Actions for continuous integration, automatically executing test and release processes.

📦 Installation

Using Pre - compiled Binaries

1. Visit the GitHub Releases page.
2. Download the corresponding binary file according to your operating system.
3. Extract and run:

# For example, on Linux:
tar -xzf linear-mcp-server-v1.0.0-linux-amd64.tar.gz
chmod +x linear-mcp-server
./linear-mcp-server

💻 Usage Examples

Basic Usage

Create an Issue

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:   "New Issue: Test MCP Server",
		Description: "This is an example issue for testing the MCP server functionality.",
		Status:      "Open", // Status can be: "Open", "In Progress", or "Resolved"
		Priority:    "High",   // Can be: "High", "Medium", or "Low"
	}

	if err := client.CreateIssue(newIssue); err != nil {
		log.Fatalf("Error creating issue: %v", err)
	}
	log.Println("Issue created successfully!")
}

📚 Documentation

Linear MCP Server Functions

• Create an Issue: Send an issue to the Linear platform via the MCP protocol.
• Get an Issue: Retrieve detailed information about a specific issue.
• Update an Issue: Modify the status, title, or description of an issue.
• Delete an Issue: Remove a specified issue from the Linear platform.

🔧 Technical Details

Project Structure

linear-mcp-server/
├── go.mod
├── go.sum
├── main.go
├── pkg/
│   ├── client/
│   │   ├── client.go       # MCP client implementation
│   │   └── types.go        # Custom data types and structs
└── README.md               # Project documentation

🤝 Contribution Guidelines

1. Clone the repository: git clone https://github.com/yourusername/linear-mcp-server.git
2. Install dependencies: go mod tidy
3. Run tests:

   go test ./...
   

4. Submit changes:
   • Create a feature branch: git checkout -b feature/new-feature
   • Commit changes: git add . && git commit -m "Add new feature"
   • Push to the remote repository: git push origin feature/new-feature

📄 License

This project is licensed under the MIT License.