MCP 服务器

Jules MCP Server

Enables orchestration of multiple Jules AI workers for tasks like code generation, bug fixing, and review using the Google Jules API. It features git integration, a shared memory system, and real-time activity monitoring for complex, multi-agent development workflows.

README

</div>

⚙️ Setup

Choose the installation method that fits your workflow. Both methods require a Jules API Key.

[!IMPORTANT] Visit jules.google.com/settings/api to generate your credentials before proceeding.

<details> <summary><b>🤖 Method 1: Agent-Driven Install (Recommended)</b></summary>

The fastest way to get started. Copy the block below and paste it into your AI assistant (Antigravity, Cursor, or Claude).

Read https://raw.githubusercontent.com/TheRealAshik/jules-mcp/main/docs/SELF_INSTALL.md and do as per the instructions. I have my JULES_API_KEY ready.

</details>

<details> <summary><b>👤 Method 2: Manual Self-Install</b></summary>

If you prefer to configure the server yourself, follow these steps:

Locate your config file:
- Antigravity: ~/.gemini/antigravity/mcp_config.json
- Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json
- Cursor: Settings > Features > MCP > Add New Server
Add the following snippet:

{
  "mcpServers": {
    "jules-mcp": {
      "command": "npx",
      "args": ["-y", "@realashik/jules-mcp"],
      "env": {
        "JULES_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

</details>

📖 Overview

Jules MCP is a high-performance Model Context Protocol (MCP) server designed to supercharge AI coding assistants. While standard AI agents are limited to linear task execution, Jules MCP introduces Staged Orchestration—enabling a "Commander" agent to deploy multiple specialized sub-agents (Maestros, Crews, Freelancers) to handle distinct parts of a project simultaneously or in sequence.

Built on top of the Google Jules API and the MCP SDK, it provides the bridge between your IDE and a distributed team of AI workers.

[!TIP] Jules MCP works best when allowed to manage its own branches. Ensure your JULES_API_KEY has repository write access for the best experience.

🚀 Features

<details> <summary><b>Click to expand features list</b></summary>

🎭 Multi-Role Orchestration: Spawn MAESTRO (Architect), CREW (Implementer), FREELANCER (Specialist), or EVALUATOR (Quality Control).
📝 Staged Workflows: Automatically manage git branches, code generation, and merging in a single, safe flow.
🧠 Global Shared Memory: Cross-session memory allows workers to pass variables and context like biological collaborators.
🛡️ Quality Enforcement: Built-in review cycles ensure code meets security and performance standards before merging.
⚡ Zero Configuration: Instantly usable via npx with automatic environment discovery. </details>

🛠 Development

# 1. Clone the repository
git clone https://github.com/TheRealAshik/jules-mcp.git

# 2. Install dependencies
npm install

# 3. Build & Run
npm run build
npm start