Complete implementation

[ValentinSattinger]

Linear MCP Implementation

This PR implements a comprehensive Model Context Protocol (MCP) integration with Linear, providing robust ticket and project management capabilities through the Linear API.

Major Features

Ticket Management

• Get Tickets: Retrieve tickets with filtering by status and pagination
• Get Ticket Details: Fetch comprehensive ticket information including:
  • Team data (name, ID, key)
  • State information
  • Label details with names and colors
  • Assignee information
  • Priority and estimates
• Update Tickets: Modify ticket properties with smart state handling
  • Support for updating to "Done" state by name (no UUID required)
  • Automatic team resolution from ticket keys
  • Validation of state transitions

Project Management

• Get Projects: List projects with search and status filtering
• Update Projects: Modify project properties including:
  • Basic information (name, description)
  • Team associations
  • Dates and progress
  • Visual properties (icon, color)

Workflow Management

• Get Workflow States: New tool to retrieve available states for a team
• Smart State Handling: Intelligent state resolution for ticket updates
• Team Context: Automatic team identification and validation

Technical Improvements

API Integration

• Combined REST and GraphQL approaches for optimal data retrieval
• Comprehensive error handling with meaningful messages
• Fallback patterns for handling incomplete data
• Type-safe interactions with Linear's API

Development Infrastructure

• ESLint and Prettier configuration for code quality
• Husky pre-commit hooks for maintaining code standards
• Comprehensive TypeScript type definitions
• Unit test setup with Vitest

Implementation Details

Architecture

• Modular handler structure for different API operations
• Type-safe request and response handling
• Efficient data fetching with GraphQL where beneficial
• Robust error handling and validation

Code Quality

• Full TypeScript implementation
• Comprehensive JSDoc documentation
• Consistent code style through ESLint/Prettier
• Unit test coverage

Testing

• Verified all main operations:
  • Ticket retrieval and updates
  • Project management
  • Workflow state handling
  • Error scenarios
• Tested with various Linear configurations
• Validated type safety and error handling

Documentation

• Detailed README with setup instructions
• Comprehensive API documentation
• Clear usage examples
• Development guide

Future Enhancements

• Implement ticket creation
• Add comment management
• Support attachment handling
• Enable custom field operations
• Add batch operations support

Breaking Changes

None. This is a new implementation.

Dependencies

• Node.js v18+
• @linear/sdk v37.0.0
• @modelcontextprotocol/sdk v1.0.4
• Various development dependencies (TypeScript, ESLint, etc.)