{"id":29360037,"url":"https://github.com/passadis/mcp-sdk-demo","last_synced_at":"2026-05-07T03:34:41.232Z","repository":{"id":303622029,"uuid":"1015725829","full_name":"passadis/mcp-sdk-demo","owner":"passadis","description":"An MCP Server use case with advanced document handling and OpenAI Integration","archived":false,"fork":false,"pushed_at":"2025-07-08T14:36:28.000Z","size":87,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-08T15:43:00.739Z","etag":null,"topics":["ai","azure","document-summarization","mcp","mcp-server","openai"],"latest_commit_sha":null,"homepage":"https://www.cloudblogger.eu/2025/07/08/the-best-way-to-learn-mcp-unlock-the-ai-future/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/passadis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-08T00:26:04.000Z","updated_at":"2025-07-08T14:36:32.000Z","dependencies_parsed_at":"2025-07-08T15:54:28.924Z","dependency_job_id":null,"html_url":"https://github.com/passadis/mcp-sdk-demo","commit_stats":null,"previous_names":["passadis/mcp-sdk-demo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/passadis/mcp-sdk-demo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passadis%2Fmcp-sdk-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passadis%2Fmcp-sdk-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passadis%2Fmcp-sdk-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passadis%2Fmcp-sdk-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/passadis","download_url":"https://codeload.github.com/passadis/mcp-sdk-demo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/passadis%2Fmcp-sdk-demo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264411163,"owners_count":23603804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ai","azure","document-summarization","mcp","mcp-server","openai"],"created_at":"2025-07-09T07:09:23.227Z","updated_at":"2026-05-07T03:34:41.206Z","avatar_url":"https://github.com/passadis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://skillicons.dev\"\u003e\n    \u003cimg src=\"https://skillicons.dev/icons?i=azure,python,vscode\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eThe best way to Learn MCP: Unlock the AI future\u003c/h1\u003e\n\n# MCP SDK Implementation\n\nThis directory contains a Demo wit Web UI using the actual Model Context Protocol (MCP) SDK.\n\n## Architecture Overview\n\nThis implementation uses the official MCP SDK to create proper MCP servers and clients.\n\n### Original Implementation (in parent directories)\n- **mcp_server_project**: Mock MCP server for agent registration and message relay\n- **agent_a_project**: Frontend agent that initiates document verification/summarization requests\n- **agent_b_project**: Backend agent that provides summarization services using Azure OpenAI\n\n### New MCP SDK Implementation\n\n#### Servers (`/servers/`)\n- **document_verification_server**: MCP server that provides document verification tools\n- **summarization_server**: MCP server that provides text summarization tools using Azure OpenAI\n\n#### Clients (`/clients/`)\n- **document_client**: MCP client that uses document verification services\n- **summarization_client**: MCP client that uses summarization services\n\n#### Shared (`/shared/`)\n- **crypto_utils.py**: Shared cryptographic utilities for secure communication\n- **config.py**: Shared configuration and environment variables\n\n## Key Differences from Original\n\n1. **Protocol**: Uses actual MCP protocol instead of custom REST API\n2. **Communication**: MCP tools and resources instead of encrypted HTTP requests\n3. **Architecture**: Proper MCP server/client model instead of peer-to-peer agents\n4. **Security**: MCP-native security features alongside custom encryption\n5. **Discoverability**: MCP schema for automatic tool discovery\n\n## Setup Instructions\n\n** Follow the Quickstart Instructions to get started!\n\n1. Install MCP SDK: `pip install mcp`\n2. Configure Azure OpenAI credentials in environment variables\n3. Run servers: Each server can be started independently\n4. Connect clients: Clients can discover and use server capabilities\n\n## Security Model\n\n- Maintains encryption for sensitive data transmission\n- Leverages MCP's built-in transport security\n- Access control through MCP server authentication\n- Public key exchange for document verification\n\n## Migration Benefits\n\n- Standard protocol compliance\n- Better tool discovery and schema validation\n- Improved error handling and logging\n- Enhanced scalability and interoperability\n- Ecosystem compatibility with MCP-aware applications\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpassadis%2Fmcp-sdk-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpassadis%2Fmcp-sdk-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpassadis%2Fmcp-sdk-demo/lists"}