mcp-builder-community

This MCP server setup provides two containers: the MCP service container and the Router/container that complements the MCP server. The MCP container runs the Apollo MCP server binary configured to read environment-based credentials, while the Router handles request routing for your GraphOS-driven MCP endpoints. To use, create a local .env file with your Apollo credentials, then start both containers so they can communicate and expose their endpoints. The recommended flow is to build both images from the provided Dockerfile setup and then run them with the environment variables loaded from .env. Once running, you can query the MCP endpoints and test your GraphOS-based MCP integration through the exposed ports (default 5000 for MCP and 4000 for Router in this setup).

Prerequisites:

• Docker installed on your system
• Access to the repository with the provided Dockerfiles (mcp.Dockerfile) for building the images
• Apollo GraphOS keys for MCP server usage

Step-by-step:

1. Prepare your environment file with Apollo credentials

   • Create a .env file in the project directory: APOLLO_KEY=service:cfp-<your-key>:... APOLLO_GRAPH_REF=cfp-<your-key>@current

2. Build the MCP and Router images

   • docker build --tag mcp-server-builder-series-mcp -f mcp.Dockerfile .
   • docker build --tag mcp-server-builder-series-router -f mcp.Dockerfile .
   • Optional: use --build-arg BUILD_ENV=local for local development variants

3. Run the containers with your environment variables

   • docker run -it --env-file .env -p 5000:5000 mcp-server-builder-series-mcp
   • docker run -it --env-file .env -p 4000:4000 mcp-server-builder-series-router

4. Verify operation

   • Access the MCP server at http://localhost:5000 (MCP) and router at http://localhost:4000 (Router)
   • Ensure the .env file is available to the containers or use --env-file to pass variables

Notes and tips:

• The environment file (.env) should contain your Apollo credentials (APOLLO_KEY and APOLLO_GRAPH_REF) as described in the README.
• If you encounter port conflicts, adjust the -p mappings in the docker run commands to free ports on your host.
• Ensure your Apollo key has the necessary permissions for MCP server operations in GraphOS.
• If you modify mcp.Dockerfile or the startup commands, rebuild the images to apply changes.
• You can switch to local development by using BUILD_ENV=local in the docker build, which may adjust defaults for development behavior.
• For troubleshooting, inspect container logs with docker logs <container_id>.