CodexAid

# CodexAid - MCP Self-Learning Service A powerful service for building, managing, and deploying self-learning and self-generating MCP (Model Context Protocol) agents. ## Overview CodexAid is a framework that allows you to create intelligent MCP agents that can learn from tasks and generate new skills on their own. The system follows a design-develop-deploy pipeline that turns natural language prompts into functional MCP servers with custom tools. ## Features - **Self-Learning**: Create agents that can learn from user interactions - **Self-Generation**: Generate new MCP servers based on natural language prompts - **Tool Generation**: Automatically create and deploy new tools based on requirements - **FastAPI Integration**: Expose MCP functionality through an HTTP API - **Design-Develop Pipeline**: Structured approach to converting tasks into working code ## Architecture The system consists of several key components: - **Designer**: Analyzes tasks and creates specifications for development - **Developer**: Implements tools based on specifications - **MCP Builder**: Constructs MCP servers from developed tools - **Tool Server**: FastAPI server that hosts and manages MCP tools ## Getting Started ### Prerequisites - Python 3.12 or higher - Dependencies listed in pyproject.toml ### Installation ```bash # Clone the repository git clone <repository-url> cd CodexAid # Create and activate a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -e . ``` ### Usage 1. Start the Tool Server: ```bash python mcp_service/tool_server.py ``` 2. Create a new MCP from a prompt: ```python from scr.work import mcp_create # Generate a new MCP server from a natural language prompt mcp_str = mcp_create("Create a tool that summarizes web content") # Save the generated server with open("my_new_mcp.py", "w") as f: f.write(mcp_str) ``` 3. Use the HTTP API to generate new MCPs: ```bash curl -X POST "http://localhost:8848/new_mcp" \ -H "Content-Type: application/json" \ -d '{"prompt": "Create a tool that searches for information"}' ``` ## API Endpoints - `GET /health` - Check server health - `GET /reset` - Reset the MCP manager - `GET /get_tool` - Get available tools - `GET /get_tool/{agent_name}` - Get tools for a specific agent - `POST /call_tool/{tool_name}` - Call a specific tool - `POST /new_mcp` - Generate a new MCP from a prompt ## Configuration Edit the `config.py` file to configure: - LLM API endpoints and keys - MCP service paths - Server port ## Examples ### Creating a Learning Timer ```python from mcp.server.fastmcp import FastMCP mcp = FastMCP("LearningTimer") @mcp.tool(description='Start a learning timer when detected') async def start_learning_timer(): # Implementation details pass if __name__ == '__main__': mcp.run(transport='stdio') ``` ## License See the LICENSE file for details. ## Contributing Contributions are welcome! Please feel free to submit a Pull Request.