Jira & Linear

🚀 MCP Development Tools

MCP Development Tools is a set of development servers designed to interact with the Model Context Protocol (MCP). This tool aims to assist developers in easily integrating and managing various services, such as Jira, Trello, and Confluence.

✨ Features

Core Components

• typescript-config: Shared TypeScript configuration files.
• http-client: Provides HTTP client functionality.

Function Packages

• jira: Integrates with Jira services, supporting the creation of tasks, issues, and comments.
• linear: Interacts with the Linear management tool.

📦 Installation

Manage the project using pnpm:

1. Install pnpm:

   npm install -g pnpm
   

2. Install project dependencies:

   pnpm install
   

3. Build all packages:

   pnpm build
   

💻 Usage Examples

Standard Output Protocol (MCP)

All MCP servers communicate via standard input/output. By default, the service listens on the following ports:

• stdin: Receives requests from the proxy.
• stdout: Sends responses or log information.

Example Configuration

// Start an MCP server
const server = new MCP.Server({
    name: 'my-server',
    version: '1.0.0'
});

server.on('request', (request, response) => {
    // Handle request logic
    response.send('Hello World!');
});

server.listen();

📚 Documentation

Development Process

Debugging Tools

Use the MCP Inspector for debugging:

pnpm inspector

After starting, the Inspector will provide a URL to access the debugging tool in the browser.

Contribution Guidelines

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature/amazing-feature
   

3. Commit changes:

   git commit -m 'Implement new feature'
   

4. Push to the branch:

   git push origin feature/amazing-feature
   

5. Create a Pull Request.

Conventional Commits Specification

Follow the Conventional Commits format:

Example Commit Messages

feat(jira): Add comment creation feature
fix(http-client): Fix timeout issue
docs: Update installation instructions in README

📄 License

This project uses the MIT license. Please refer to the LICENSE file for specific details.

🔧 Troubleshooting

Common Issues

1. Connection Issues:

   • Ensure that the API credentials are correct.
   • Check network connectivity.
   • Verify the URL and workspace name.

2. Permission Errors:

   • Confirm that the account has appropriate permissions.
   • Check if the API token has the required permissions enabled.

3. Command Not Found:

   • When using npx, ensure a connection to the npm registry.
   • Check if the package installation was successful.

🚀 Future Plans

• Add new service integrations (GitHub, Confluence, etc.).
• Enhance security features.
• Support custom authentication methods.
• Expand query functionality.
• Optimize performance.

We welcome community feedback and contributions to help improve these tools.