chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00
commit c275ba2868
13613 changed files with 2980806 additions and 0 deletions
@@ -0,0 +1,54 @@
+# MCP Calculator Server (Python)
+
+
+
+A simple Model Context Protocol (MCP) server implementation in Python that provides basic calculator functionality.
+
+
+## Installation
+
+Install the required dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+Or install the MCP Python SDK directly:
+
+```bash
+pip install mcp>=1.18.0
+```
+
+## Usage
+
+### Running the Server
+
+The server is designed to be used by MCP clients (like Claude Desktop). To start the server:
+
+```bash
+python mcp_calculator_server.py
+```
+
+**Note**: When run directly in a terminal, you'll see JSON-RPC validation errors. This is normal behavior - the server is waiting for properly formatted MCP client messages.
+
+### Testing the Functions
+
+To test that the calculator functions work correctly:
+
+```bash
+python test_calculator.py
+```
+
+## Troubleshooting
+
+### Import Errors
+
+If you see `ModuleNotFoundError: No module named 'mcp'`, install the MCP Python SDK:
+
+```bash
+pip install mcp>=1.18.0
+```
+
+### JSON-RPC Errors When Running Directly
+
+Errors like "Invalid JSON: EOF while parsing a value" when running the server directly are expected. The server needs MCP client messages, not direct terminal input.