{"id":29882788,"url":"https://github.com/day50-dev/simplest-mcp-server","last_synced_at":"2026-04-15T23:31:25.029Z","repository":{"id":306830298,"uuid":"1027349527","full_name":"day50-dev/Simplest-MCP-Server","owner":"day50-dev","description":"This is the simplest MCP server and simplest MCP client possible","archived":false,"fork":false,"pushed_at":"2025-07-27T20:58:50.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-27T22:25:06.363Z","etag":null,"topics":["example","mcp","mcp-client","mcp-server"],"latest_commit_sha":null,"homepage":"https://day50.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/day50-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-27T20:54:02.000Z","updated_at":"2025-07-27T20:59:45.000Z","dependencies_parsed_at":"2025-07-27T22:40:42.121Z","dependency_job_id":null,"html_url":"https://github.com/day50-dev/Simplest-MCP-Server","commit_stats":null,"previous_names":["day50-dev/simplest-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/day50-dev/Simplest-MCP-Server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/day50-dev%2FSimplest-MCP-Server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/day50-dev%2FSimplest-MCP-Server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/day50-dev%2FSimplest-MCP-Server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/day50-dev%2FSimplest-MCP-Server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/day50-dev","download_url":"https://codeload.github.com/day50-dev/Simplest-MCP-Server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/day50-dev%2FSimplest-MCP-Server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31864936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["example","mcp","mcp-client","mcp-server"],"created_at":"2025-07-31T12:44:15.432Z","updated_at":"2026-04-15T23:31:25.013Z","avatar_url":"https://github.com/day50-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simplest MCP Ever\n\nThis repository demonstrates a minimal, working example of an MCP server and client. There's no LLM involved, this uses what's called the \"stdio\" method.\n\nHowever, there are branches that introduce things such as LLMs. After understanding the base code, go to the various branches to see how things get stacked on top.\n\n## Functionality\n\nThis example server exposes a single tool:\n\n*   **`get_users_favorite_number`**: This tool, when called, simply returns the string \"42\" as the user's favorite number.  This is a *very* basic example illustrating the server's capability to expose tools and return results.\n\n## Repository Contents\n\n*   **`server.py`**: This is the core of the MCP server. It defines:\n    *   The server initialization (`Server(\"favorite-number-server\")`).\n    *   The `list_tools` function, responsible for providing the list of available tools to the client.\n    *   The `call_tool` function, which handles the execution of the tool based on the tool name and arguments.\n\n*   **`test_mcp.py`**: This file contains an automated test for the MCP server. It connects to the server, lists the available tools, calls the `get_users_favorite_number` tool, and asserts that the returned value is \"42\".\n\n*   **`test.sh`**: A simple shell script to execute the tests. It activates the virtual environment (if one exists) before running the test to ensure dependencies are correctly managed.\n\n\n## Getting Started\n\nFollow these steps to run the example:\n\n3.  **Set up a Virtual Environment (Recommended):**\n\n    ```bash\n    python3 -m venv venv\n    source venv/bin/activate  # On Linux/macOS\n    # venv\\Scripts\\activate  # On Windows\n    ```\n\n4.  **Install the `mcp` library:**\n\n    ```bash\n    python3 -m pip install mcp\n    ```\n\n5.  **Run the Tests:**\n\n    ```bash\n    ./test.sh\n    ```\n\n    This script will:\n    *   Activate the virtual environment (if it exists).\n    *   Execute the `test_mcp.py` file, which will start the server, connect to it, call the tool, and verify the results.\n\n    If the test passes, you'll see the following output (or similar):\n\n    ```\n    🧪 Testing Favorite Number MCP Server\n    ✓ Server initialized: favorite-number-server\n    ✓ Available tools: ['get_users_favorite_number']\n    ✓ Tool result: 42\n    ✓ Test passed! Favorite number is 42\n    ✅ All tests passed!\n    ```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fday50-dev%2Fsimplest-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fday50-dev%2Fsimplest-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fday50-dev%2Fsimplest-mcp-server/lists"}