obox-mcp
Integrates with GitHub Copilot in VS Code to provide project automation, language management, file system search, and system utilities for AI-assisted development.
Integrates with Google Antigravity to enable AI agents to run commands, manage projects, and navigate the file system.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@obox-mcp Find all Python files with TODO comments"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

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
fdandripgrep.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 Configuration
Go to: Settings -> Cursor Settings -> General -> MCP -> Add new global MCP server.
Paste the following configuration into your Cursor
~/.cursor/mcp.jsonfile.
{
"mcpServers": {
"obox": {
"command": "uv",
"args": [
"run",
"--project",
"/absolute/path/to/obox",
"/absolute/path/to/obox/main.py"
]
}
}
}VS Code Configuration
Open Command Palette (
Ctrl+Shift+P/Cmd+Shift+P).Type:
MCP: Open User Configuration.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"
]
}
}
}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.pyManual 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 Configuration
Open Command Palette (
Ctrl+Shift+P/Cmd+Shift+P).Type:
Antigravity: Manage MCP Servers.Click View Raw Config.
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>RulesClaude Code:
CLAUDE.mdOther Clients: The equivalent system prompt or rules setting.
Available Tools
3 toolsjust_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
Scored across 3 tools
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.
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.
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.
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
Orbit is an MCP server that gives your AI agents a 4000+ tools, a shared memory brain and a live dashboard OS. Every agent reads active decisions, logs outputs to a searchable vault, and reports status in real time. 2-minute setup via MCP; works across Claude, ChatGPT, Codex, Cursor, Gemini, and Manus. Finally Agents work, agents that grow your business and bring you customers. https://orbitagents.xyz
Hyperion β MCP tool marketplace for AI agents: web, OSINT, security, research via one key.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceAn 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 PyPI5-
- AlicenseNot gradedqualityCmaintenanceA 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
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to research, plan, generate requirements, create starter projects, analyze codebases, and execute multi-step software development workflows through MCP tools.42 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to research, plan, generate requirements, map codebases, create starter projects, manage tasks, and run multi-step software development workflows through MCP tools.42 npmMIT