Atlassian MCP Server Client

A command-line client for connecting to Model Context Protocol (MCP) servers, specifically designed to work with Atlassian's official MCP server integration. This client provides an interactive chat interface powered by OpenAI for seamless interaction with remote MCP servers.

🚀 Features

• Remote MCP Server Connection: Connect to any MCP server via mcp-remote
• Interactive Chat Interface: Command-line chat interface with OpenAI integration
• OAuth Support: Automatic OAuth handling for Atlassian services through mcp-remote
• Tool Discovery: Automatically discovers and utilizes tools provided by the MCP server
• Streaming Responses: Real-time streaming of AI responses
• Cross-Platform: Works on Windows, macOS, and Linux

📋 Prerequisites

• Node.js 18.0.0 or higher
• npm package manager
• OpenAI API key

🛠️ Installation

1. Clone the repository:

   git clone <repository-url>
   cd jira-mcp-server

2. Install dependencies:

   npm install

3. Set up environment variables:

   cp env.example .env

4. Configure your OpenAI API key: Edit the .env file:

   # OpenAI Configuration
   OPENAI_API_KEY=your_openai_api_key

🔐 Getting Your OpenAI API Key

1. Visit OpenAI API Keys
2. Create a new API key
3. Copy it to your .env file

🚀 Usage

Connect to Atlassian's Official MCP Server

npm run dev

This will connect to https://mcp.atlassian.com/v1/sse by default.

Connect to a Custom MCP Server

npm run dev <server-url>

Example:

npm run dev wss://your-custom-mcp-server.com

Development Commands

• npm run build - Compile TypeScript to JavaScript
• npm run dev [server-url] - Run in development mode (defaults to Atlassian MCP server)
• npm run clean - Remove build artifacts
• npm run typecheck - Run TypeScript type checking

💬 Interactive Chat

Once connected, you'll see an interactive prompt where you can:

• Ask questions about your Atlassian workspace (if connected to Atlassian MCP server)
• Use natural language to interact with any tools provided by the MCP server
• Get AI-powered responses using the connected server's capabilities

Example Session

🔗 Connecting to remote MCP server: https://mcp.atlassian.com/v1/sse
🔐 OAuth authentication will be handled automatically by mcp-remote
🌐 A browser window may open for authentication
🤝 Connecting to MCP server...
🛠️ Setting up tools...
✅ Connected successfully with tools: [list-jira-issues, search-confluence, ...]

💬 Chat with AI (type 'help' for commands, 'exit' to quit):
> What are my recent Jira issues?

🤖 Processing query...
Here are your recent Jira issues...

Special Commands

• help - Show available commands and usage information
• list-tools - Display all tools available from the connected MCP server
• exit or quit - Exit the application

🔧 Configuration

Environment Variables

Variable	Description	Required
OPENAI_API_KEY	Your OpenAI API key	✅

OAuth Authentication

When connecting to Atlassian's MCP server, OAuth authentication is handled automatically by mcp-remote. A browser window will open for you to authenticate with your Atlassian account if needed.

🏗️ Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   CLI Client    │◄──►│   mcp-remote    │◄──►│   MCP Server    │
│   (this app)    │    │                 │    │   (Atlassian)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   OpenAI API    │    │ OAuth Handler   │    │ Atlassian APIs  │
│                 │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

🛠️ How It Works

1. Connection: The client uses mcp-remote to establish a connection to the specified MCP server
2. Authentication: OAuth flows are handled automatically by mcp-remote
3. Tool Discovery: Available tools are discovered from the MCP server
4. Chat Interface: User queries are processed using OpenAI with the discovered tools
5. Tool Execution: Tools are called on the remote MCP server as needed

🐛 Troubleshooting

Common Issues

1. "OPENAI_API_KEY is not set"

   • Ensure your .env file contains a valid OpenAI API key

2. "mcp-remote installation failed"

   • The application will try to install mcp-remote globally automatically
   • If it fails, install manually: npm install -g mcp-remote

3. OAuth authentication fails

   • Ensure you have access to the Atlassian workspace
   • Check that your browser allows popups from the authentication domain
   • Verify network connectivity

4. Connection timeout

   • Check if the MCP server URL is correct and accessible
   • Verify firewall settings allow outbound connections

Debug Mode

For verbose logging, you can check the mcp-remote logs or modify the source code to add more logging.

🔗 Dependencies

• @ai-sdk/openai: OpenAI integration for AI capabilities
• @modelcontextprotocol/sdk: Official MCP SDK for client implementation
• mcp-remote: Remote MCP server connection utility (auto-installed)
• ai: AI SDK for tool integration and streaming

📚 Learn More

• Model Context Protocol - Official MCP documentation
• Atlassian MCP Server - Atlassian's official MCP server
• OpenAI API Documentation - OpenAI API reference

---

Note: This is a client application for connecting to MCP servers. For the actual MCP server implementation, refer to the official Atlassian MCP server documentation.