---
slug: "crewai"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/dshivendra/crewai_mcp_adapter@main/README.md"
repo: "https://github.com/dshivendra/crewai_mcp_adapter"
source_file: "README.md"
branch: "main"
---
[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/dshivendra-crewai-mcp-adapter-badge.png)](https://mseep.ai/app/dshivendra-crewai-mcp-adapter)

# CrewAI MCP Adapter

A Python library extending CrewAI's adapter ecosystem with [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) integration support and comprehensive tooling for custom agent and tool development.

## Features

- 🔌 Native CrewAI integration and adapter patterns 
- 🛠️ MCP protocol support for tool integration
- 🧩 Easy-to-use interface for extending and creating new adapters
- 📝 Type-safe implementation with Pydantic
- 🔍 JSON Schema validation for tool parameters
- 🚀 Async/await support
- 📊 Detailed execution metadata

## Installation

You can install the package directly from PyPI:

```bash
pip install crewai-adapters
```

Or install from source:

```bash
pip install git+https://github.com/dshivendra/crewai_mcp_adapter.git
```

## Quick Start

```python
from crewai import Agent, Task
from crewai_adapters import CrewAIAdapterClient
from crewai_adapters.types import AdapterConfig

async def main():
    async with CrewAIAdapterClient() as client:
        # Connect to MCP server
        await client.connect_to_mcp_server(
            "math",
            command="python",
            args=["math_server.py"]
        )

        # Create agent with tools
        agent = Agent(
            name="Calculator",
            goal="Perform calculations",
            tools=client.get_tools()
        )

        # Execute task
        task = Task(
            description="Calculate (3 + 5) × 12",
            agent=agent
        )
        result = await task.execute()
        print(f"Result: {result}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())
```

## Documentation

For detailed documentation, see:
- [Getting Started Guide](https://github.com/dshivendra/crewai_mcp_adapter/blob/HEAD/docs/index.md)
- [API Reference](https://github.com/dshivendra/crewai_mcp_adapter/blob/HEAD/docs/api_reference.md)
- [Examples](https://github.com/dshivendra/crewai_mcp_adapter/blob/HEAD/docs/examples.md)

## Development

### Prerequisites

- Python 3.11 or higher
- `crewai` package
- `pydantic` package
- `mcp` package

### Install Development Dependencies

```bash
pip install -e ".[test,docs]"
```

### Running Tests

```bash
pytest tests/ -v
```

## Publishing

To publish a new version to PyPI:

1. Update version in pyproject.toml
2. Build the package:
   ```bash
   python -m build
   ```
3. Upload to PyPI:
   ```bash
   python -m twine upload dist/*
   ```

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.