scaffold-mcp-agent

This project is a scaffold for an agent orchestrator (using agent framework like Langgraph, CrewAI, OpenAI Agents) and an MCP (Message Communication Protocol) Server using (modelcontextprotocol). It comes with the necessary setup for integration with OpenAI llms, dockerized services, and communication via Server-Sent Events (SSE) for remote connections. You will need to set up environment variables and install several tools before running the project.

Prerequisites

Before running the project, make sure you have the following tools installed:

• Docker: A platform for developing, shipping, and running applications.
• Docker Compose: A tool for defining and running multi-container Docker applications.
• Make: A build automation tool to help run commands in a consistent manner.

sudo apt install make

• NVM: Node Version Manager, used to install and manage multiple versions of Node.js.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

• Node.js: JavaScript runtime required for some services in this project.

nvm list
nvm install v20.19.0
nvm install v22.14.0

• PYENV: A tool for managing multiple versions of Python.

curl https://pyenv.run | bash
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

• Python: Required for orchestrator functionality.

pyenv install 3.11.11
pyenv local 3.11.11

• ngrok: Required for tunnel n8n to OAuth on salesforce

curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
  && echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
  | sudo tee /etc/apt/sources.list.d/ngrok.list \
  && sudo apt update \
  && sudo apt install ngrok

And make an account for setup an authtoken within ngrok

Installation guides:

• Docker Installation Guide
• Docker Compose Installation Guide
• Make Installation Guide
• NVM Installation Guide
• Node.js Installation Guide
• Pyenv Installation Guide
• Python Installation Guide
• Ngrok Installation Guide

Setup

1. Clone the Repository

First, clone this repository to your local machine:

git clone git@github.com:eduardocastillo-creai/scaffold-mcp-agent.git
cd scaffold-mcp-agent

2. Enable ngrok to the port for n8n instance

This is required for OAuth callback (deafult port for n8n 5678)

ngrok http 5678

3. Set .env files for all folders

• agent-orchestrator/.env:

PORT=3000
OPENAI_API_KEY=

• crewai-orchestrator/.env:

PORT=8080
OPENAI_API_KEY=

• mcp-airbnb-server/.env:

PORT=3005

• mcp-airbnb-server/.env:

PORT=3005

• mcp-client-space-server/.env:

PORT=3001

• mcp-figma-server/.env:

PORT=3004
FIGMA_API_KEY=

• mcp-n8n-salesforce-server/.env:

PORT=3003
N8N_WEBHOOK_URI=https://<random-number>.ngrok-free.app/webhook/salesforce

• mcp-rag-server/.env:

PORT=3002
OPENAI_API_KEY=

4. Set OAuth callback on salesforce

This is a guide for set OAuth on n8n salesforce Guide for auth n8n salesforce

Ensure to use the same route for ngrok that link the callback and the n8n container. Like this: https://<random>.ngrok-free.app/rest/oauth2-credential/callback

5. Run MCP Servers and Orchestrators using docker compose

docker-compose up -d

6. GET Request to orchestrator (agent) using query param

curl "http://0.0.0.0:3000/call-agent?query=Can%20you%20calculate%20my%20bmi,%2066kg%20and%20170cm"

Or use Postman.