Mo

🚀 Mo Task Management Tool Documentation

Mo is a Model Context Protocol (MCP) server designed for the Cursor IDE. It enables integration with Linear, offering issue tracking and task management capabilities.

🚀 Quick Start

Mo is an MCP server tailored for Cursor IDE, facilitating seamless integration with Linear. This empowers users with efficient issue tracking and task management functionalities.

✨ Features

Core Features

• Implementation of the MCP server
• Command processing module
• Data persistence storage
• Linear API integration
• Utility helper functions
• Type definitions

Command Support

• Task management commands
• Queries for Linear teams and projects
• Issue tracking functionality

Integration Capabilities

• Support for Cursor IDE
• Integration with Claude chat mode
• Command-line tool interface

📦 Installation

Full Package Installation

npm install mo-mcp

Manual Installation

1. Download the source code archive: mo-linear-mcp-v1.0.0.zip
2. Extract the files to a specified directory
3. Run the startup script:

node dist/index.js

📚 Documentation

Configuration Guide

MCP Server Configuration

Edit the config.json file and add the following:

{
  "mcp_port": 3000,
  "linear_api_key": "your_linear_api_key",
  "data_storage_path": "data"
}

Example Configuration File

// Example of config.json
{
  "mcp_port": 3000,
  "linear_api_key": "123456789abcdefg",
  "data_storage_path": "./data"
}

Usage Commands

Account Authentication

/mo linear-auth key:your_linear_api_key

Example Usage

Run the following commands in the terminal:

# Get the list of Linear teams
/mo linear-teams

# Query projects of a specified team
/mo linear-projects team:team-id

# Sync data to Linear
/mo linear-sync

Development Guide

Project Architecture

mo-linear-mcp/
├── src/             # Source code directory
│   ├── index.ts     # Entry file
│   ├── server.ts    # MCP server implementation
│   ├── commands/    # Command processing module
│   ├── data/        # Data persistence storage
│   ├── linear/      # Linear API integration
│   ├── utils/       # Utility helper functions
│   └── types/       # Type definition files
├── data/            # Local data storage directory
└── docs/            # Documentation resources
    ├── architecture/  # Architecture documentation
    ├── mcp/           # MCP-related documentation
    ├── linear/        # Linear integration documentation
    └── features/      # Feature description documentation

Development Commands

# Build the project
npm run build

# Start debug mode
npm run dev

# Monitor file changes
npm run watch

# Run the code linter
npm run lint

# Execute test cases
npm test

Release Guide

# Prepare a release version
npm version major/minor/patch

# Commit changes
git add package.json package-lock.json
git commit -m "version upgrade"

# Push to the remote repository
git push origin main

Debugging Tips

Debug Log Output

DEBUG=mo-linear-mcp npm run dev

Troubleshooting Common Issues

1. Check if the configuration file is loaded correctly.
2. Ensure that the Linear API key is valid.
3. Review the console error messages.

Documentation Resources

• Architecture Design Document
• Detailed MCP Explanation
• Linear Integration Guide
• Feature List

📄 License

No license information provided in the original document.

⚠️ Important Note

This project is still under development. The interfaces and features may change. Please refer to the final version.

📊 Project Status

• Version: v1.0.0
• Development Status: In development
• Start Date: October 1, 2023
• Planned Completion Date: June 30, 2024

Stage Milestones: