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,37 @@
+# Run sample
+
+This sample starts an MCP Server with a middleware that checks for a valid Authorization header.
+
+## Install dependencies
+
+```bash
+pip install "mcp[cli]" 
+```
+
+## Start server
+
+```bash
+python server.py
+```
+
+start the client in another terminal
+
+```bash
+python client.py
+```
+
+You should see a result similar to:
+
+```text
+2025-09-30 13:25:54 - mcp_client - INFO - Tool result: meta=None content=[TextContent(type='text', text='{\n  "current_time": "2025-09-30T13:25:54.311900",\n  "timezone": "UTC",\n  "timestamp": 1759238754.3119,\n  "formatted": "2025-09-30 13:25:54"\n}', annotations=None, meta=None)] structuredContent={'current_time': '2025-09-30T13:25:54.311900', 'timezone': 'UTC', 'timestamp': 1759238754.3119, 'formatted': '2025-09-30 13:25:54'} isError=False
+```
+
+this means the credential being sent through is being allowed.
+
+Try changing the credential in `client.py` to "secret-token2", then you should see this text as part of the response:
+
+```text
+2025-09-30 13:27:44 - httpx - INFO - HTTP Request: POST http://localhost:8000/mcp "HTTP/1.1 403 Forbidden"
+```
+
+this means you were authenticated (you had a credential), but it was invalid.