super-agent-party MCP工具

Hardware requirements

• CPU: 2 cores or more
• Memory: 2GB or more

Because all models are optional, you can access the local deployment engine, or you can all use the Cloud as a Service provider interface, so there are few hardware requirements. Test the docker version on the 2-core 2G Cloud as a Service server and it will work fine

Windows portable package (Recommended! Installation-free source version, support one-click synchronization to the latest version of the warehouse, no need to wait for the desktop version to be packaged)

👉 Click to download

👉 中国用户点击下载

⭐ Note! You can double-click 一键更新(update).bat to update the software, or you can double-click 一键启动(start).bat to start the software.The operating system must be Windows 10/11, Windows Server 2025, or a later version!

Windows Desktop Installation

👉 Click to download

👉 中国用户点击下载

⭐ Note! Choose to install only for the current user during installation, otherwise, administrator privileges will be required to start.The operating system must be Windows 10/11, Windows Server 2025, or a later version!

MacOS Integrated Package (Currently only supports M chips, no-install source code version, supports one-click sync to the latest repository version, no need to wait for desktop version packaging)

Suitable for developers/advanced users: No-install source code version, supports one-click sync to the latest repository version, no need to wait for desktop version packaging.

👉 International users click to download

👉 中国用户点击下载

🚀 Usage Steps

1. Remove Network Download Quarantine (Important) After downloading and extracting, open Terminal, enter the following command (note there is a space at the end), then drag the extracted folder into the Terminal window and press Enter:

sudo xattr -rd com.apple.quarantine 

2. Grant Script Execution Permissions Navigate to the folder in Terminal and execute:

chmod +x 一键更新(update).sh 一键启动(start).sh

3. Run the Software - First use/Update: It is recommended to first execute ./一键更新(update).sh to ensure dependencies are synced to the latest. - Daily startup: Directly execute ./一键启动(start).sh.

MacOS Desktop Installation (Currently only M chips are supported.)

👉 Click to download

👉 中国用户点击下载

⭐Attention! After downloading, drag the app file of the dmg file into the /Applications directory, then open end point, execute the following command and enter the root password to remove the attached Quarantine attribute from the network download:

  sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app
  

Linux Desktop Installation

We provide two mainstream Linux installation package formats for your convenience in different scenarios.

1. Install using .AppImage

.AppImage is a Linux application format that does not require installation and can be used immediately. Suitable for most Linux distributions.

👉 Click to download

2. Install using .deb package (Suitable for Ubuntu/Debian systems)

👉 Click to download

Docker Deployment (This version of the desktop pet can only be viewed through a browser)

International Users (Docker Hub)

docker pull ailm32442/super-agent-party:latest
docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest

Chinese Users (Alibaba Cloud ACR, faster pull)

docker pull crpi-9mgnqijkd7wc42x2.cn-shenzhen.personal.cr.aliyuncs.com/ailm32442/super-agent-party:latest
docker run -d -p 3456:3456 -v ./super-agent-data:/app/data crpi-9mgnqijkd7wc42x2.cn-shenzhen.personal.cr.aliyuncs.com/ailm32442/super-agent-party:latest

⭐ Note! ./super-agent-data can be replaced with any local folder. After Docker starts, all data will be cached in this local folder and will not be uploaded anywhere.

Out of the box: Visit http://localhost:3456/

---

Docker Compose Deployment (This version of the desktop pet can only be viewed through a browser, and an additional gateway container will be started for login management)

International Users (Docker Hub)

git clone https://github.com/heshengtao/super-agent-party.git
cd super-agent-party
docker-compose up -d

Chinese Users (Alibaba Cloud ACR, faster pull)

git clone https://github.com/heshengtao/super-agent-party.git
cd super-agent-party
docker-compose -f docker-compose-acr.yml up -d

⭐ Note! The default username is root, and the default password is pass. Please change the password after the first login.

Out of the box: Visit http://localhost:3456/

API key management: Visit http://localhost:3456/token.html

Lite client that matches your Docker version, turning Docker into a desktop app

👉 SAP-lite-Windows-exe

👉 SAP-lite-MacOS-dmg

Source Code Deployment

  git clone https://github.com/heshengtao/super-agent-party.git
  cd super-agent-party
  uv sync
  npm install
  npm run dev
  

Quick Start

Usage

• Desktop: Click the desktop icon to use immediately.

• Web or docker: Access http://localhost:3456/ after startup.

• API call: Developer-friendly, perfectly compatible with OpenAI format, can output in real-time, and does not affect the original API's response speed. No need to modify the calling code:

  from openai import OpenAI
  client = OpenAI(
    api_key="super-secret-key",
    base_url="http://localhost:3456/v1"
  )
  response = client.chat.completions.create(
    model="super-model",
    messages=[
        {"role": "user", "content": "What is Super Agent Party?"}
    ]
  )
  print(response.choices[0].message.content)
  

• MCP call: After starting, you can invoke the local MCP service by writing the following content in the configuration file:

  {
    "mcpServers": {
      "super-agent-party": {
        "url": "http://127.0.0.1:3456/mcp",
      }
    }
  }
  

If you are a CLI Agent

CLI Agent needs to check the documentation at README_AGENT.md. Please refer to this document to guide users through installing this software!

If you are a human using a CLI Agent

Send this link to your AI, and the AI will guide you through installing this software!

https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md

Extension

Added a brand-new extension system. You can check available plugins at plugins list, or directly view and install them in the party under 【Developer】->【Extensions】. You can also add your own developed extensions to the official plugin list at super-agent-party.github.io!

Existing Extension