pidhornyidanylo/mcp-demo

About

Full stack MCP server simulator.

Tools

backend: NestJS (localhost:8080) frontend: Next.JS (localhost:3000) mcp server: Express + TS (localhost:4001) db: PostgreSql + Prisma (localhost:5432)

Install & launch

For smooth and quick launch use Docker (if available):

1. Open terminal from the root folder of the app
2. Run command docker compose up (docker compose up -d)
3. You are ready to start. Running apps are on ports above

App flow

1. Open frontend app -> you see a list of 14 available tools (sidebar)
2. Click on any tool (let's choose "changeSlackStatus" for the test)
3. Click Invoke Tool tab
4. You will see a list of expected arguments for the current tool ("status" for "changeSlackStatus").
5. Action will change your current Slack status to the one you passed as an argument.
6. Fill in textarea value with (JSON): { "status": "touching grass 🎋" }
7. Hit Invoke Tool button
8. Open Activity Log tab -> you will see your last tool invoke at the top and the status at the right
9. Click on "changeSlackStatus" to see details
10. In case of error tool invoke status would be Error
11. To clear invokes history hit Clear button

DB

Tool invokes history is saved to db. To view:

1. Open new terminal
2. docker exec -it mcp_postgres psql -U user -d mcp_db
3. \dt
4. SELECT * FROM tool_invokes;

Happy coding and stable AWS!