https://github.com/kikzi/agents-mcp-usage
Repo for demonstrating simple Model Context Protocol (MCP) server with several Agent Frameworks
https://github.com/kikzi/agents-mcp-usage
adk-python gemini langchain-python langchain-typescript llm mcp mcp-client mcp-server modelcontextprotocol nodejs openai python tool-call typescript
Last synced: about 1 month ago
JSON representation
Repo for demonstrating simple Model Context Protocol (MCP) server with several Agent Frameworks
- Host: GitHub
- URL: https://github.com/kikzi/agents-mcp-usage
- Owner: kikzi
- Created: 2025-04-27T17:02:15.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-09-28T02:47:08.000Z (about 1 month ago)
- Last Synced: 2025-09-28T04:21:16.502Z (about 1 month ago)
- Topics: adk-python, gemini, langchain-python, langchain-typescript, llm, mcp, mcp-client, mcp-server, modelcontextprotocol, nodejs, openai, python, tool-call, typescript
- Language: Python
- Size: 6.06 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **agents-mcp-usage** - Demonstrate Agentic use of Model Context Protocol (MCP) server tools with several Agent Frameworks `python` `adk-python` `gemini` `langchain-python` `langchain-typescript` `pip install git+https://github.com/kikzi/agents-mcp-usage` (🤖 AI/ML)
README
# 🚀 Agents MCP Usage
  
Welcome 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.
## Table of Contents
- [Introduction](#introduction)
- [Features](#features)
- [Technologies Used](#technologies-used)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Releases](#releases)
## Introduction
The 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.
## Features
- **Multiple Agent Frameworks**: Supports various frameworks for flexibility.
- **Easy Setup**: Simple installation process to get you started quickly.
- **Comprehensive Examples**: Includes examples to demonstrate functionality.
- **Open Source**: Freely available for modification and enhancement.
## Technologies Used
This project utilizes several technologies and frameworks:
- **Python**: The primary programming language.
- **ADK-Python**: For developing agent-based applications.
- **Pydantic**: For data validation and settings management.
- **OpenAI**: For integrating AI capabilities.
- **Gemini**: For advanced agent functionalities.
- **Logfire**: For logging and monitoring.
- **MCP Server**: The core of the project, implementing the Model Context Protocol.
## Installation
To get started with this repository, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/kikzi/agents-mcp-usage.git
cd agents-mcp-usage
```
2. Install the required dependencies:
```bash
pip install -r requirements.txt
```
3. Set up your environment variables if needed.
4. Run the server:
```bash
python main.py
```
## Usage
After installing, you can start using the MCP server.
1. **Start the Server**: Ensure the server is running.
2. **Interact with Agents**: Use the provided examples to interact with different agents.
3. **Monitor Logs**: Check logs for debugging and monitoring purposes.
For more detailed usage instructions, please refer to the examples provided in the `examples` directory.
## Contributing
We welcome contributions to improve this repository. If you have suggestions or enhancements, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes.
4. Push to your fork and create a pull request.
Please ensure your code adheres to the existing style and includes appropriate tests.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact
For questions or suggestions, please reach out:
- **Author**: [Your Name](https://github.com/yourprofile)
- **Email**: your.email@example.com
## Releases
To 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.
For the latest updates and versions, check the [Releases](https://github.com/kikzi/agents-mcp-usage/releases) page regularly.
---
Thank you for your interest in the Agents MCP Usage repository! We hope you find it useful for your projects and research. Happy coding!