agent  by 1mcp-app

Unified server for AI assistant context protocols

Created 7 months ago
259 stars

Top 98.0% on SourcePulse

GitHubView on GitHub
Project Summary

1MCP addresses the complexity of managing disparate Model Context Protocol (MCP) servers for various AI assistants. It offers a unified server implementation that aggregates multiple MCP instances, providing a single, simplified endpoint for developers and users interacting with diverse AI clients. This streamlines configuration and access, enhancing workflow efficiency.

How It Works

1MCP functions as a sophisticated proxy, managing and aggregating multiple MCP servers. It initiates and terminates these servers as subprocesses, efficiently forwarding requests from AI assistants to the correct underlying MCP instance. This architecture establishes a singular entry point for all MCP traffic, significantly reducing management overhead and simplifying integration.

Quick Start & Requirements

  • Installation: Recommended binary installation avoids Node.js dependency. Download via curl (Linux/macOS) or Invoke-WebRequest (Windows) from latest GitHub releases. NPM installation via npx -y @1mcp/agent.
  • Prerequisites: Binary install requires no Node.js. NPM install requires Node.js. Specific MCP servers may have unique dependencies.
  • Setup: Add MCP servers using 1mcp mcp add <name> -- <command>, e.g., 1mcp mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents. Start the server with 1mcp. Connect AI assistants by configuring their settings to the 1MCP URL (e.g., http://127.0.0.1:3050/mcp).
  • Docs: Complete Documentation, Quick Start.

Highlighted Details

  • Unified Interface: Aggregates diverse MCP servers into one accessible endpoint.
  • OAuth 2.1 Authentication: Production-ready security with scope-based authorization.
  • High Performance: Efficient request forwarding and robust error handling.
  • Security Focus: Stdio transport isolation, input sanitization, and comprehensive audit logging.
  • Health Monitoring: Built-in health check endpoints for observability.
  • Configuration: Single JSON file with hot-reload support.

Maintenance & Community

The project provides contribution guidelines via CONTRIBUTING.md. No specific community channels (Discord/Slack), sponsorships, or public roadmap are detailed in the README.

Licensing & Compatibility

  • License: Apache License 2.0.
  • Compatibility: Permissive license suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

The README does not specify known limitations, alpha/beta status, or outstanding issues. The project appears actively maintained via latest release downloads.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
15
Issues (30d)
3
Star History
63 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.