agentic-ai-mcp 0.5.0

A lightweight agentic AI framework with MCP tool serving

Agentic AI MCP

Lightweight agentic AI with MCP tools. Supports distributed setups where tools run on one machine and agents on another.

Install

pip install agentic-ai-mcp

Setup

Set your Anthropic API key in .env file (only needed on the client/agent machine):

ANTHROPIC_API_KEY=sk-...

Quick Start

See the example notebooks:

• examples/quickstart_server.ipynb - Run on machine exposing tools
• examples/quickstart_client.ipynb - Run on machine executing agents

Usage

Server Mode (expose tools)

Run this on the machine where you want to host tools:

from agentic_ai_mcp import AgenticAI

def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b

def greet(name: str, times: int = 1) -> str:
    """Greet someone."""
    return ("Hello, " + name + "! ") * times

# Create and register tools
ai = AgenticAI(host="0.0.0.0", port=8888)
ai.register_tool(add)
ai.register_tool(greet)

# Start server
ai.run_mcp_server()

# Stop when done
ai.stop_mcp_server()

Client Mode (run agents)

Run this on another machine to connect to the server and execute agents:

from agentic_ai_mcp import AgenticAI

# Connect to remote MCP server
ai = AgenticAI(mcp_url="http://<server-ip>:8888/mcp")

# Simple agent workflow
result = await ai.run("Calculate 2+3 and greet Tom the result times")
print(result)

# Planning-based workflow for complex tasks
result = await ai.run_with_planning("First calculate ((1+2)+(1+1)+3), then greet Alice that many times")
print(result)

Methods

Method	Description
ai.register_tool(func)	Register a function as an MCP tool
ai.run_mcp_server()	Start MCP server in background
ai.stop_mcp_server()	Stop the MCP server
ai.run(prompt)	Simple agent workflow
ai.run_with_planning(prompt)	Complex agent workflow

License

MIT