vibeteam


Namevibeteam JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryMCP server for orchestrating sub-agents based on query analysis
upload_time2025-08-08 20:43:01
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords agents ai claude mcp orchestration
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Vibeteam

An MCP (Model Context Protocol) server that intelligently orchestrates sub-agents based on query analysis and project context.

## Features

- **Query Analysis**: Understands user intent (build, debug, feature, refactor, research, etc.)
- **Project Detection**: Automatically identifies project type (backend, frontend, fullstack, library)
- **Smart Agent Orchestration**: Deploys specialized agents based on project context and query intent
- **Parallel Execution**: Runs multiple agents concurrently for faster results
- **Tool Detection**: Automatically adapts to Cursor, Windsurf, VS Code, Claude Desktop, etc.
- **Multi-Agent Support**:
  - Backend Specialist
  - Frontend Specialist
  - Web Researcher
  - Code Analyzer
  - Test Engineer
  - DevOps Specialist

## Installation

### Via uvx (Recommended)

Once published to PyPI, you can install and run directly with uvx:

```bash
uvx vibeteam
```

### Via pip

```bash
pip install vibeteam
```

### From Source

```bash
git clone https://github.com/XiaoConstantine/vibeteam.git
cd vibeteam
uv sync
uv run vibeteam
```

## MCP Configuration

Add to your Claude Desktop or MCP client configuration:

```json
{
  "servers": {
    "vibeteam": {
      "command": "uvx",
      "args": ["vibeteam"]
    }
  }
}
```

Or if installed via pip:

```json
{
  "servers": {
    "vibeteam": {
      "command": "vibeteam"
    }
  }
}
```

## Usage

### As MCP Server

The server runs as an MCP server and exposes tools for Claude or other MCP clients:

```bash
# Run with uvx
uvx vibeteam

# Or if installed
vibeteam
```

### Testing

```bash
uv run python test_server.py
```

## Tools Available

1. **analyze_and_orchestrate**: Main orchestration tool that analyzes query and deploys agents
2. **analyze_project**: Analyzes project structure and technology stack
3. **analyze_query**: Determines query intent and complexity

## How It Works

1. **Project Analysis**: Scans the current working directory to understand project structure
2. **Query Understanding**: Analyzes user query to determine intent and complexity
3. **Agent Planning**: Based on project type and query intent, plans appropriate agents
4. **Orchestration**: Executes agents in priority order and collects results
5. **Summary**: Provides consolidated output from all agents

## Architecture

The orchestrator uses a sophisticated analysis system to:
- Detect backend (Python, Go, Java, etc.) and frontend (React, Vue, Angular) technologies
- Understand query complexity and required expertise
- Deploy agents with appropriate priority levels
- Coordinate multi-agent workflows for complex tasks

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "vibeteam",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "Xiao <constantine124@gmail.com>",
    "keywords": "agents, ai, claude, mcp, orchestration",
    "author": null,
    "author_email": "Xiao <constantine124@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/15/d1/28a575b15835c58d605db0e8f065a176350f39102f69be971d29ab625acc/vibeteam-0.1.1.tar.gz",
    "platform": null,
    "description": "# Vibeteam\n\nAn MCP (Model Context Protocol) server that intelligently orchestrates sub-agents based on query analysis and project context.\n\n## Features\n\n- **Query Analysis**: Understands user intent (build, debug, feature, refactor, research, etc.)\n- **Project Detection**: Automatically identifies project type (backend, frontend, fullstack, library)\n- **Smart Agent Orchestration**: Deploys specialized agents based on project context and query intent\n- **Parallel Execution**: Runs multiple agents concurrently for faster results\n- **Tool Detection**: Automatically adapts to Cursor, Windsurf, VS Code, Claude Desktop, etc.\n- **Multi-Agent Support**:\n  - Backend Specialist\n  - Frontend Specialist\n  - Web Researcher\n  - Code Analyzer\n  - Test Engineer\n  - DevOps Specialist\n\n## Installation\n\n### Via uvx (Recommended)\n\nOnce published to PyPI, you can install and run directly with uvx:\n\n```bash\nuvx vibeteam\n```\n\n### Via pip\n\n```bash\npip install vibeteam\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/XiaoConstantine/vibeteam.git\ncd vibeteam\nuv sync\nuv run vibeteam\n```\n\n## MCP Configuration\n\nAdd to your Claude Desktop or MCP client configuration:\n\n```json\n{\n  \"servers\": {\n    \"vibeteam\": {\n      \"command\": \"uvx\",\n      \"args\": [\"vibeteam\"]\n    }\n  }\n}\n```\n\nOr if installed via pip:\n\n```json\n{\n  \"servers\": {\n    \"vibeteam\": {\n      \"command\": \"vibeteam\"\n    }\n  }\n}\n```\n\n## Usage\n\n### As MCP Server\n\nThe server runs as an MCP server and exposes tools for Claude or other MCP clients:\n\n```bash\n# Run with uvx\nuvx vibeteam\n\n# Or if installed\nvibeteam\n```\n\n### Testing\n\n```bash\nuv run python test_server.py\n```\n\n## Tools Available\n\n1. **analyze_and_orchestrate**: Main orchestration tool that analyzes query and deploys agents\n2. **analyze_project**: Analyzes project structure and technology stack\n3. **analyze_query**: Determines query intent and complexity\n\n## How It Works\n\n1. **Project Analysis**: Scans the current working directory to understand project structure\n2. **Query Understanding**: Analyzes user query to determine intent and complexity\n3. **Agent Planning**: Based on project type and query intent, plans appropriate agents\n4. **Orchestration**: Executes agents in priority order and collects results\n5. **Summary**: Provides consolidated output from all agents\n\n## Architecture\n\nThe orchestrator uses a sophisticated analysis system to:\n- Detect backend (Python, Go, Java, etc.) and frontend (React, Vue, Angular) technologies\n- Understand query complexity and required expertise\n- Deploy agents with appropriate priority levels\n- Coordinate multi-agent workflows for complex tasks\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MCP server for orchestrating sub-agents based on query analysis",
    "version": "0.1.1",
    "project_urls": {
        "Homepage": "https://github.com/XiaoConstantine/vibeteam",
        "Repository": "https://github.com/XiaoConstantine/vibeteam"
    },
    "split_keywords": [
        "agents",
        " ai",
        " claude",
        " mcp",
        " orchestration"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "addd1b49356d365a5b3c55a02d3828972c0c00c73fc886ad4599c2ec9efc017a",
                "md5": "0286ae035e5d6c2b4357dcd93d2611de",
                "sha256": "821d161a8e8c09c6c263c67adcecfd0f0eefc311223eed59ccca80ee1659c38b"
            },
            "downloads": -1,
            "filename": "vibeteam-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0286ae035e5d6c2b4357dcd93d2611de",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 30147,
            "upload_time": "2025-08-08T20:43:00",
            "upload_time_iso_8601": "2025-08-08T20:43:00.532041Z",
            "url": "https://files.pythonhosted.org/packages/ad/dd/1b49356d365a5b3c55a02d3828972c0c00c73fc886ad4599c2ec9efc017a/vibeteam-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "15d128a575b15835c58d605db0e8f065a176350f39102f69be971d29ab625acc",
                "md5": "e27a6c2925a7b076822b225c86f49d9c",
                "sha256": "d4c636922c14a4d31d4c032445b0d9b5266ac0a5fa7d1fee49638beda4914700"
            },
            "downloads": -1,
            "filename": "vibeteam-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "e27a6c2925a7b076822b225c86f49d9c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 112879,
            "upload_time": "2025-08-08T20:43:01",
            "upload_time_iso_8601": "2025-08-08T20:43:01.782514Z",
            "url": "https://files.pythonhosted.org/packages/15/d1/28a575b15835c58d605db0e8f065a176350f39102f69be971d29ab625acc/vibeteam-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-08 20:43:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "XiaoConstantine",
    "github_project": "vibeteam",
    "github_not_found": true,
    "lcname": "vibeteam"
}
        
Elapsed time: 1.29098s