mcpagentai 0.4.0

A generic multi-tool MCP Agent with Time, Weather, Dictionary, Calculator, etc.

MCPAgentAI 🚀

MCPAgentAI is a standardized tool wrapping framework for implementing and managing diverse tools in a unified way. It is designed to help developers quickly integrate and launch tool-based use cases.

Key Features

• 🔧 Standardized Wrapping: Provides an abstraction layer for building tools using the MCP protocol.
• 🚀 Flexible Use Cases: Easily add or remove tools to fit your specific requirements.
• ✨ Out-of-the-Box Tools: Includes pre-built tools for common scenarios:
  • 🕑 Time utilities
  • ☁️ Weather information (API)
  • 📚 Dictionary lookups
  • 🧮 Calculator for mathematical expressions
  • 💵 Currency exchange (API)
  • 📈 Stocks Data: Access real-time and historical stock market information.
  • 🤖 ElizaOS Integration: Seamlessly connect and interact with ElizaOS for enhanced automation.
  • 🐦 Twitter Management: Automate tweeting, replying, and managing Twitter interactions.

Tech Stack 🛠️

• Python: Core programming language
• MCP Framework: Communication protocol
• Docker: Containerization

🤔 What is MCP?

The Model Context Protocol (MCP) is a cutting-edge standard for context sharing and management across AI models and systems. Think of it as the language AI agents use to interact seamlessly. 🧠✨

Here’s why MCP matters:

• 🧩 Standardization: MCP defines how context can be shared across models, enabling interoperability.
• ⚡ Scalability: It’s built to handle large-scale AI systems with high throughput.
• 🔒 Security: Robust authentication and fine-grained access control.
• 🌐 Flexibility: Works across diverse systems and AI architectures.

source

Installation 📦

Install via PyPI

pip install mcpagentai

---

Usage 💻

Run Locally

mcpagentai --local-timezone "America/New_York"

Run in Docker

1. Build the Docker image:

   docker build -t mcpagentai .
   

2. Run the container:

   docker run -i --rm mcpagentai
   

---

Tutorial: Selecting Specific Tools

You can configure MCPAgentAI to run only certain tools by modifying the agent configuration in your server or by updating the server.py file to only load desired agents. For example:

from mcpagentai.tools.time_agent import TimeAgent
from mcpagentai.tools.weather_agent import WeatherAgent
from mcpagentai.core.multi_tool_agent import MultiToolAgent

multi_tool_agent = MultiToolAgent([
    TimeAgent(),
    WeatherAgent()
])

This setup will only enable Time and Weather tools.

---

Integration Example: Claude Desktop Configuration

You can integrate MCPAgentAI with Claude Desktop using the following configuration:

claude_desktop_config.json

{
    "mcpServers": {
        "mcpagentai": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "mcpagentai"]
        }
    }
}

---

Development 🛠️

1. Clone this repository:

   git clone https://github.com/mcpagents-ai/mcpagentai.git
   cd mcpagentai
   

2. (Optional) Create a virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate
   

3. Install dependencies:

   pip install -e .
   

4. Build the package:

   python -m build
   

5. Run tests:

   pytest
   

---

Contributing 🤝

We welcome contributions! Please open an issue or pull request.

---

License: MIT
Enjoy! 🎉