{"id":31531204,"url":"https://github.com/kikzi/agents-mcp-usage","last_synced_at":"2025-10-04T02:02:14.564Z","repository":{"id":290246920,"uuid":"973752292","full_name":"kikzi/agents-mcp-usage","owner":"kikzi","description":"Repo for demonstrating simple Model Context Protocol (MCP) server with several Agent Frameworks","archived":false,"fork":false,"pushed_at":"2025-09-28T02:47:08.000Z","size":6350,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-28T04:21:16.502Z","etag":null,"topics":["adk-python","gemini","langchain-python","langchain-typescript","llm","mcp","mcp-client","mcp-server","modelcontextprotocol","nodejs","openai","python","tool-call","typescript"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"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/kikzi.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-27T17:02:15.000Z","updated_at":"2025-09-28T02:47:12.000Z","dependencies_parsed_at":"2025-06-30T17:29:56.820Z","dependency_job_id":"dbad533c-cb21-4ad2-af83-994bc9e6a3fe","html_url":"https://github.com/kikzi/agents-mcp-usage","commit_stats":null,"previous_names":["kikzi/agents-mcp-usage"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kikzi/agents-mcp-usage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikzi%2Fagents-mcp-usage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikzi%2Fagents-mcp-usage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikzi%2Fagents-mcp-usage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikzi%2Fagents-mcp-usage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kikzi","download_url":"https://codeload.github.com/kikzi/agents-mcp-usage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikzi%2Fagents-mcp-usage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278254467,"owners_count":25956600,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["adk-python","gemini","langchain-python","langchain-typescript","llm","mcp","mcp-client","mcp-server","modelcontextprotocol","nodejs","openai","python","tool-call","typescript"],"created_at":"2025-10-04T02:01:46.586Z","updated_at":"2025-10-04T02:02:14.552Z","avatar_url":"https://github.com/kikzi.png","language":"Python","funding_links":[],"categories":["🤖 AI/ML"],"sub_categories":[],"readme":"# 🚀 Agents MCP Usage\n\n![GitHub Repo Stars](https://img.shields.io/github/stars/kikzi/agents-mcp-usage?style=social) ![GitHub Issues](https://img.shields.io/github/issues/kikzi/agents-mcp-usage) ![GitHub License](https://img.shields.io/github/license/kikzi/agents-mcp-usage)\n\nWelcome to the **Agents MCP Usage** repository! This repository demonstrates a simple Model Context Protocol (MCP) server using various Agent Frameworks. It serves as a practical example for developers and researchers interested in the integration of agents with the MCP architecture.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Technologies Used](#technologies-used)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n- [Releases](#releases)\n\n## Introduction\n\nThe Model Context Protocol (MCP) is a standardized way for agents to communicate and operate within a shared context. This repository provides a straightforward implementation of an MCP server that interacts with multiple agent frameworks. It showcases how different agents can work together to solve complex problems using a common protocol.\n\n## Features\n\n- **Multiple Agent Frameworks**: Supports various frameworks for flexibility.\n- **Easy Setup**: Simple installation process to get you started quickly.\n- **Comprehensive Examples**: Includes examples to demonstrate functionality.\n- **Open Source**: Freely available for modification and enhancement.\n\n## Technologies Used\n\nThis project utilizes several technologies and frameworks:\n\n- **Python**: The primary programming language.\n- **ADK-Python**: For developing agent-based applications.\n- **Pydantic**: For data validation and settings management.\n- **OpenAI**: For integrating AI capabilities.\n- **Gemini**: For advanced agent functionalities.\n- **Logfire**: For logging and monitoring.\n- **MCP Server**: The core of the project, implementing the Model Context Protocol.\n\n## Installation\n\nTo get started with this repository, follow these steps:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/kikzi/agents-mcp-usage.git\n   cd agents-mcp-usage\n   ```\n\n2. Install the required dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Set up your environment variables if needed.\n\n4. Run the server:\n   ```bash\n   python main.py\n   ```\n\n## Usage\n\nAfter installing, you can start using the MCP server. \n\n1. **Start the Server**: Ensure the server is running.\n2. **Interact with Agents**: Use the provided examples to interact with different agents.\n3. **Monitor Logs**: Check logs for debugging and monitoring purposes.\n\nFor more detailed usage instructions, please refer to the examples provided in the `examples` directory.\n\n## Contributing\n\nWe welcome contributions to improve this repository. If you have suggestions or enhancements, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Commit your changes.\n4. Push to your fork and create a pull request.\n\nPlease ensure your code adheres to the existing style and includes appropriate tests.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor questions or suggestions, please reach out:\n\n- **Author**: [Your Name](https://github.com/yourprofile)\n- **Email**: your.email@example.com\n\n## Releases\n\nTo download the latest version, visit the [Releases](https://github.com/kikzi/agents-mcp-usage/releases) section. Download the necessary files and execute them to get started.\n\nFor the latest updates and versions, check the [Releases](https://github.com/kikzi/agents-mcp-usage/releases) page regularly.\n\n---\n\nThank you for your interest in the Agents MCP Usage repository! We hope you find it useful for your projects and research. Happy coding!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkikzi%2Fagents-mcp-usage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkikzi%2Fagents-mcp-usage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkikzi%2Fagents-mcp-usage/lists"}