Quick Start

1. Install 1MCP

Binary (Recommended - No Node.js Required):

# Linux/macOS
curl -L https://github.com/1mcp-app/agent/releases/latest/download/1mcp-linux-x64.tar.gz | tar -xz
sudo mv 1mcp /usr/local/bin/

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/1mcp-app/agent/releases/latest/download/1mcp-win32-x64.zip" -OutFile "1mcp.zip"
Expand-Archive -Path "1mcp.zip" -DestinationPath "."

NPM:

npx -y @1mcp/agent --help

2. Add MCP Servers

1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents

3. Start the Server

1mcp

4. Connect Your AI Assistant

For Cursor, add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=cursor"
    }
  }
}

For VSCode, add to settings.json:

{
  "servers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=vscode"
    }
  }
}

Install MCP Server to VSCode

For Claude Code:

claude mcp add -t http 1mcp "http://127.0.0.1:3050/mcp?app=claude-code"

That's it! All your MCP servers are now available through one unified endpoint. 🎉

Commands

Core Commands

• 1mcp [serve] - Start the 1MCP server (default command)
• 1mcp mcp add <name> - Add a new MCP server to configuration
• 1mcp mcp list - List all configured MCP servers
• 1mcp mcp status [name] - Show server status and details

For detailed command usage, run: 1mcp <command> --help

Documentation

📚 Complete Documentation - Comprehensive guides, API reference, and examples

Key Topics

• Installation Guide - Binary, NPM, and Docker installation
• Quick Start - Get running in 5 minutes
• Configuration - CLI flags and environment variables
• Authentication - OAuth 2.1 security setup
• Architecture - How 1MCP works internally
• Development - Contributing and building from source

How It Works

1MCP acts as a proxy, managing and aggregating multiple MCP servers. It starts and stops these servers as subprocesses and forwards requests from AI assistants to the appropriate server. This architecture allows for a single point of entry for all MCP traffic, simplifying management and reducing overhead.

Contributing

Contributions are welcome! Please read our CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.