My First MCP

My First MCP is an MCP server that provides a starter template and execution environment implemented in Node.js with full Docker support. It connects local development environments and container runtimes to Model Context Protocol clients such as Claude Desktop. Software developers and engineers who are beginning to build or test custom tools use this project as a minimal foundational template. The project enables developers to run an MCP server directly using Node.js or packaged inside a container using Docker. In addition to running standard standard input and output communication, the server supports conversion from stdio to Server-Sent Events through a dedicated gateway Dockerfile. This enables developers to test both standard local integration and network-exposed SSE streaming setups for their tools. By providing ready-to-use Docker build instructions for cross-platform deployments alongside straightforward configuration templates, My First MCP allows users to evaluate MCP tool development without setting up boilerplate server infrastructure from scratch. Developers can extend the codebase to expose custom tools, resources, and prompts while testing client interoperability.

Category: Other & General Purpose

Tags: docker, nodejs, starter, template

Visit My First MCP

How to install and configure My First MCP

Follow these steps to build and register My First MCP with your MCP client: 1. Clone the repository and build the container or compile your Node.js distribution files. 2. To build the stdio Docker image, run: bash docker build -t my-first-mcp-stdio . 3. Alternatively, to build the SSE gateway, run: bash docker build -t my-first-mcp-gateway -f Dockerfile.sse . docker run --rm -p 8181:8000 my-first-mcp-gateway 4. Open your MCP client configuration (such as claude_desktop_config.json) and configure either the Node or Docker runner under mcpServers: For Node: json { "mcpServers": { "my-first-mcp": { "command": "node", "args": ["/absolute/path/to/your/dist/index.js"] } } } For Docker: json { "mcpServers": { "my-first-mcp": { "command": "docker", "args": ["run", "-i", "--rm", "my-first-mcp"] } } } 5. Restart your MCP client to initiate the server.

What you can do with My First MCP

• Creating a baseline Node.js MCP server implementation to evaluate custom tools and prompts in local desktop clients. - Running containerized MCP services with Docker stdio transport to ensure isolated dependencies across development environments. - Converting standard input and output MCP communications to Server-Sent Events using the included gateway Dockerfile configuration. - Building cross-platform multi-architecture container images targeting x86 and ARM platforms for cloud or cluster deployments. - Testing client-to-server connectivity and message formatting in Claude Desktop or Cursor before writing complex production logic.

Key facts

• https://github.com/JHSeo-git/my-first-mcp
• Other & General Purpose
• docker, nodejs, starter, template

Part of MCP Servers

What is My First MCP?

My First MCP is a template project and server implementation designed to help developers create Model Context Protocol services using Node.js and Docker. It provides a simple foundation for hosting tools and resources, supporting both standard input and output execution and Server-Sent Events through a container gateway.

How do I run My First MCP with Docker?

You can run the server in Docker using stdio by building the image with the command docker build -t my-first-mcp-stdio . and executing docker run -i --rm my-first-mcp-stdio. Alternatively, you can use the Docker configuration snippet inside your MCP client settings file to automate execution.

How does My First MCP support SSE transport?

The project includes a dedicated Dockerfile.sse configuration that wraps the standard input and output stream into a Server-Sent Events gateway. You build the image using docker build -t my-first-mcp-gateway -f Dockerfile.sse . and run it mapped to port 8181 to accept remote network connections.

Which MCP clients work with My First MCP?

Any client that implements the Model Context Protocol can connect to My First MCP. This includes desktop applications like Claude Desktop and modern AI code editors like Cursor. You configure the server by adding its launch command to your client JSON configuration file.