Back to Home
milkymap icon

omnimcp

Verified Safe

by milkymap

Overview

Acts as a semantic router to discover and execute tools across multiple Model Context Protocol (MCP) servers, reducing context bloat for large language models by exposing a single meta-tool.

Installation

Run Command
docker run --rm -d -v /path/to/qdrant_data:/data/qdrant -v /path/to/tool_offloaded_data:/data/tool_offloaded_data -v /path/to/mcp-servers.json:/app/config/mcp-servers.json:ro --env-file .env.docker -p 8000:8000 --name omnimcp milkymap/omnimcp:latest serve

Environment Variables

  • OPENAI_API_KEY
  • CONFIG_PATH
  • TOOL_OFFLOADED_DATA_PATH
  • QDRANT_DATA_PATH
  • QDRANT_URL
  • QDRANT_API_KEY
  • EMBEDDING_MODEL_NAME
  • DESCRIPTOR_MODEL_NAME
  • VISION_MODEL_NAME
  • MAX_RESULT_TOKENS
  • DESCRIBE_IMAGES
  • DIMENSIONS

Security Notes

The server employs robust configuration management using Pydantic Settings, prioritizing environment variables for sensitive data (API keys, storage paths). Internal communication within the `MCPEngine` utilizes in-process ZeroMQ (pyzmq), which is secure for internal messaging and doesn't expose external network ports for this purpose. The `ContentManager` uses UUIDs for filenames when offloading content, effectively mitigating path traversal vulnerabilities. Tool arguments are processed via `json.loads`, which is generally safe when inputs are constrained by LLM tool calling standards. The project builds upon the `FastMCP` framework, inheriting its security posture; no obvious new network vulnerabilities are introduced within OmniMCP's code. Overall, security practices appear solid, but rely on the integrity of complex upstream dependencies and proper environmental configuration.

Similar Servers

Stats

Interest Score66
Security Score8
Cost ClassMedium
Avg Tokens700
Stars17
Forks3
Last Update2025-12-08

Tags

mcpai-agentstool-routingsemantic-searchllmcontext-managementai