Skip to main content
Glama
obox-mcp

obox-mcp

by vinhgiga

Cover Image

Click the image to watch the video tutorial.

πŸš€ Obox MCP: Project Setup & Integration

English | TiαΊΏng Việt

This guide explains how to install and integrate Obox MCP into your coding environment.

Obox MCP is a comprehensive development toolkit designed to supercharge your IDE. It provides:

  • Project Automation: Manage dependencies and run tasks with just.

  • Language Tools: Manage Node.js, Python, and .NET environments.

  • File System: Advanced file search and navigation with fd and ripgrep.

  • System Utilities: Cross-platform installers and shell integration.


πŸ†š Why Obox MCP?

❌ Without Obox MCP

LLMs are isolated execution environments. They cannot see your system or run code. You get:

  • ❌ Manual Execution: The AI code suggests commands, but you have to switch to the terminal to run them.

  • ❌ Blind Guessing: The AI hallucinates file paths or project structures it can't see.

  • ❌ Outdated Context: You have to manually copy-paste file contents for the AI to understand your project.

βœ… With Obox MCP

Obox MCP gives your AI agent hands and eyes. It can autonomously run commands, manage files, and navigate your project without you lifting a finger.

Add use obox to your prompt:

"Find all Python files containing 'TODO' and list their locations."

"Initialize a new FastAPI project, install dependencies, and run the server."

Obox MCP fetches real-time project info, executes complex build tasks, and manages your environment directly. No tab-switching, no manual copy-pasting, just results.


Related MCP server: Nexus-MCP

πŸ›  Prerequisites

Obox MCP is optimized to run using Astral uv. Ensure you have uv installed on your system:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -c "Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force"
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

πŸ”Œ Client Configuration

Cursor MCP docs

Cursor Configuration

  1. Go to: Settings -> Cursor Settings -> General -> MCP -> Add new global MCP server.

  2. Paste the following configuration into your Cursor ~/.cursor/mcp.json file.

{
  "mcpServers": {
    "obox": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/obox",
        "/absolute/path/to/obox/main.py"
      ]
    }
  }
}

VS Code MCP docs

VS Code Configuration

  1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P).

  2. Type: MCP: Open User Configuration.

  3. Paste the content into the file.

{
  "servers": {
    "obox": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/obox",
        "/absolute/path/to/obox/main.py"
      ]
    }
  }
}

Claude Code MCP docs

CLI Command

Run the following command in your terminal to add the MCP server:

claude mcp add obox -- uv run --project /absolute/path/to/obox /absolute/path/to/obox/main.py

Manual Configuration (Claude Desktop)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "obox": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/obox",
        "/absolute/path/to/obox/main.py"
      ]
    }
  }
}

Antigravity MCP docs

Antigravity Configuration

  1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P).

  2. Type: Antigravity: Manage MCP Servers.

  3. Click View Raw Config.

  4. Paste the content into the file.

{
  "mcpServers": {
    "obox": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/obox",
        "/absolute/path/to/obox/main.py"
      ]
    }
  }
}

πŸ’‘ Important Tips

Add a Rule

To avoid typing use obox in every prompt, add a rule to your MCP client to automatically invoke Obox tools for development tasks.

Recommendation: Copy the content of .github/copilot-instructions.md into:

  • Cursor: Cursor Settings > Rules

  • Claude Code: CLAUDE.md

  • Other Clients: The equivalent system prompt or rules setting.

Available Tools

3 tools
just_project_runnerB

Finalizes project setup by detecting structure. Call this tool immediately after creating any new project.

Inputs: root_working_directory (required). Returns: result

obox_fastapi_init_projectA

Initializes a new FastAPI project at the specified path. Sets up uv environment with the specified Python version and installs fastapi[standard].

Args: path: The absolute path where the project should be initialized. python_version: The Python version to use (default: "3.12").

Inputs: path (required), python_version. Returns: result

react_init_projectA

Initializes a new React project at the specified path. Setup includes:

  • Vite (React + TypeScript)

  • Tailwind CSS v4

  • TanStack Query

  • Tabler Icons React

Args: path: The absolute path where the project should be initialized.

Inputs: path (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: one initializes FastAPI, one initializes React, and one finalizes any newly created project. There is no functional overlap between them.

    Naming Consistency3/5

    The two initialization tools follow a similar pattern (framework_init_project), but the finalizer tool (just_project_runner) uses a completely different naming style. Additionally, one tool has the 'obox_' prefix while the other does not, causing inconsistency.

    Tool Count5/5

    Three tools is a well-scoped count for a project scaffolding server. Each tool serves a distinct purpose and the count is within the ideal 3-15 range.

    Completeness3/5

    The tool set covers the init and finalize lifecycle for FastAPI and React, but lacks support for other common frameworks and has no additional operations like listing projects or managing dependencies. The finalizer is somewhat disconnected from the init tools, requiring manual invocation.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      An autonomous AI development agent that enables full-stack coding, automated verification, RAG-powered code search, and quality assurance through MCP tools. Supports Gemini CLI, Claude Code CLI, with features like parallel verification, security scanning, and spec-driven development.
      71 PyPI
      5
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive Model Context Protocol toolkit that transforms AI assistants into autonomous agents capable of executing real-world tasks across filesystems, web requests, Git workflows, databases, system commands, and AI integrations.
      MIT