🚀 Atlassian FastMCP Server 🛠️

Welcome to the Atlassian FastMCP Server! 🌟 This project is a blazingly fast, lightweight Model Context Protocol (MCP) server that seamlessly integrates Atlassian tools like Jira and Confluence directly into your AI workflows! 🤖✨

🎯 What does this do?

This MCP server provides a set of highly useful tools that allow AI agents to manage your Atlassian ecosystem effortlessly. From fetching current profiles to creating sprints and generating tickets, this server brings agile management straight to your fingertips! 🖐️💻

🛠️ Available Tools

📝 Jira Management

• get_current_user 👤: Fetch the profile of the currently authenticated Jira/Atlassian user.

• get_projects 🗂️: Get a beautiful list of all Jira projects in your workspace.

• search_issues 🔍: Run powerful JQL (Jira Query Language) queries to find exactly the tickets you need!

• create_issue ➕: Quickly spin up new tasks, stories, or bugs directly in a specified project!

🏃‍♂️ Agile & Sprint Operations (NEW! 🎉)

• get_boards 📋: Fetch agile boards (with optional filtering by project key) to find where your sprints live!

• create_sprint 🏃: Generate a brand new Sprint for your team's board, complete with custom goals! 🥅

• update_sprint 🔄: Manage your sprint's lifecycle! Start an active sprint with start/end dates, or close out a finished one! 🏁

📚 Confluence Knowledge Base

• get_confluence_spaces 🌌: Discover all the knowledge spaces available in your Confluence instance.

• search_confluence 🕵️‍♂️: Use CQL (Confluence Query Language) to find documents, meeting notes, and specs.

• get_confluence_page 📄: Pull the rich content (body storage) of any specific Confluence page by its ID!

• create_confluence_page ✍️: Create brand new Confluence pages directly from your AI (supports parent pages)!

Related MCP server: Jira & Confluence MCP Server

🔐 Setup & Authentication 🗝️

To get this bad boy running, you need to provide your Jira credentials. The server loads your credentials directly from a .env file (which is safely ignored by Git! 🤫).

1. Create a .env file in the root of the project.

2. Add your credentials:

   JIRA_EMAIL=your.email@example.com
   JIRA_API_TOKEN=your_atlassian_api_token
   ATLASSIAN_URL=https://your-domain.atlassian.net
   ATLASSIAN_READ_ONLY=false

🔑 How to get your Atlassian API Key:

1. Go to your Atlassian Account Security page.

2. Click Create API token.

3. Give it a memorable label (e.g., "FastMCP Server").

4. Copy the token and paste it into your .env file!

🚀 Running the Server

Make sure you have your dependencies installed:

pip install -r requirements.txt

Then, fire up the server! 🔥

python server.py

The server will start up and listen on standard input/output (stdio) for fast, secure MCP communication! 🚄

⚙️ MCP Client Configuration 🔌

To use this server with your favorite MCP client (like Claude Desktop, Cursor, or Antigravity), simply add it to your client's configuration file (e.g., mcp_config.json or claude_desktop_config.json):

{
  "mcpServers": {
    "atlassian-mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/atlassian-mcp/server.py"
      ]
    }
  }
}

Note: Make sure to replace /absolute/path/to/ with the actual path where you cloned this repository! 🗺️

🤝 Contributing & Updates

Want to add more Jira magic? 🧙‍♂️ Feel free to fork, update server.py, and run the included update_config.py scripts to sync your fresh tools!

Happy building! 👷‍♀️🎉