mcpagents-ai/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:
🐦 Twitter Management: Automate tweeting, replying, and managing Twitter interactions.
💸 Crypto: Get the latest cryptocurrency prices.
🤖 ElizaOS Integration: Seamlessly connect and interact with ElizaOS for enhanced automation.
🕑 Time utilities
☁️ Weather information (API)
📚 Dictionary lookups
🧮 Calculator for mathematical expressions
💵 Currency exchange (API)
📈 Stocks Data: Access real-time and historical stock market information.
[WIP] 📰 News: Retrieve the latest news headlines.
### 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
bash
pip install mcpagentai
## Usage 💻
### Run Locally
bash
mcpagentai --local-timezone "America/NewYork"
### Run in Docker
1. Build the Docker image:
docker build -t mcpagentai .
2. Run the container:
docker run -i --rm mcpagentai
## Twitter Integration 🐦
MCPAgentAI offers robust Twitter integration, allowing you to automate tweeting, replying, and managing Twitter interactions. This section provides detailed instructions on configuring and using the Twitter integration, both via Docker and .env + scripts/runagent.sh.
### Docker Environment Variables for Twitter Integration
When running MCPAgentAI within Docker, it's essential to configure environment variables for Twitter integration. These variables are divided into two categories:
#### 1. Agent Node Client Credentials
These credentials are used by the Node.js client within the agent for managing Twitter interactions.
dockerfile
ENV TWITTERUSERNAME=
ENV TWITTERPASSWORD=
ENV TWITTEREMAIL=
#### 2. Tweepy (Twitter API v2) Credentials
These credentials are utilized by Tweepy for interacting with Twitter's API v2.
dockerfile
ENV TWITTERAPIKEY=
ENV TWITTERAPISECRET=
ENV TWITTERACCESSTOKEN=
ENV TWITTERACCESSSECRET=
ENV TWITTERCLIENTID=
ENV TWITTERCLIENTSECRET=
ENV TWITTERBEARERTOKEN=
### Running MCPAgentAI with Docker
1. Build the Docker image:
bash
docker build -t mcpagentai .
2. Run the container:
bash
docker run -i --rm mcpagentai
### Running MCPAgentAI with .env + scripts/runagent.sh
#### Setting Up Environment Variables
Create a .env file in the root directory of your project and add the following environment variables: