1MCP Agent logo

1MCP Agent

by 1mcp-app

A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one. It simplifies AI assistant integration by providing a single interface for multiple MCP servers.

View on GitHub

Last updated: N/A

What is 1MCP Agent?

1MCP (One MCP) is a unified Model Context Protocol server that aggregates multiple MCP servers into a single interface. It simplifies the management and configuration of AI assistants by reducing resource usage and providing a standardized way for AI models to interact with external tools.

How to use 1MCP Agent?

  1. Run the 1MCP server using npx @1mcp/agent with optional configuration file or transport type. 2. Configure your AI assistant (e.g., Cursor) to use the 1MCP server's URL. 3. Use tags to filter which MCP servers are available to different clients.

Key features of 1MCP Agent

  • Aggregates multiple MCP servers into one unified interface

  • Reduces system resource usage by eliminating redundant server instances

  • Simplifies configuration management across different AI assistants

  • Provides a standardized way for AI models to interact with external tools and resources

  • Supports dynamic configuration reloading without server restart

  • Handles graceful shutdown and resource cleanup

Use cases of 1MCP Agent

  • Integrating multiple AI assistants (Claude Desktop, Cursor, etc.) with different MCP servers.

  • Simplifying the configuration and management of AI assistants.

  • Reducing system resource usage by consolidating MCP server instances.

  • Providing a standardized interface for AI models to interact with external tools and resources.

FAQ from 1MCP Agent

What is the default transport type?

The default transport type is SSE.

How do I specify a configuration file?

Use the --config or -c option followed by the path to the configuration file.

How do I filter servers by tags?

Use the --tags or -g option followed by a comma-separated list of tags.

Can I use environment variables to configure 1MCP?

Yes, you can use environment variables prefixed with ONE_MCP_ (e.g., ONE_MCP_PORT, ONE_MCP_TAGS).

How do I run 1MCP using Docker?

You can pull the latest image from ghcr.io/1mcp-app/agent:latest and run it with appropriate port mappings and environment variables.