ModuleNotFoundError: No module named 'mcp'

[d4rk8l1tz]

@MervinPraison I referred to the closed issue #439. But that did not solve the problem.
pip install -U "praisonaiagents[mcp]"

M1 Mac.

Using the sample script

`from praisonaiagents import Agent, MCP

search_agent = Agent(
instructions="""You help book apartments on Airbnb.""",
llm="gpt-4o-mini",
tools=MCP("npx -y @openbnb/mcp-server-airbnb --ignore-robots-txt")
)

search_agent.start("I want to book an apartment in Paris for 2 nights. 03/28 - 03/30 for 2 adults")
`
from https://docs.praison.ai/mcp/airbnb

gives me the below error.

/Users/x/IdeaProjects/praisonai-env/bin/python /Users/x/IdeaProjects/praisonai-env/app.py Traceback (most recent call last): File "/Users/x/IdeaProjects/praisonai-env/app.py", line 1, in <module> from praisonaiagents import Agent, MCP File "/Users/x/IdeaProjects/praisonai-env/lib/python3.9/site-packages/praisonaiagents/__init__.py", line 13, in <module> from .mcp.mcp import MCP File "/Users/x/IdeaProjects/praisonai-env/lib/python3.9/site-packages/praisonaiagents/mcp/__init__.py", line 4, in <module> from .mcp import MCP File "/Users/x/IdeaProjects/praisonai-env/lib/python3.9/site-packages/praisonaiagents/mcp/mcp.py", line 12, in <module> from mcp import ClientSession, StdioServerParameters ModuleNotFoundError: No module named 'mcp'

[d4rk8l1tz]

i think its not able to find ClientSession StdioServerParameters. but that maybe due to the module import problem as well

[MervinPraison]

@d4rk8l1tz Did it work if you separately install mcp like this?

pip install mcp

[MervinPraison]

@d4rk8l1tz Also try creating a virtual env and test it

conda create -n praisonai python=3.11 -y
conda activate praisonai
pip install praisonaiagents mcp

[d4rk8l1tz]

@d4rk8l1tz Did it work if you separately install mcp like this?

pip install mcp

pip install mcp

ERROR: Could not find a version that satisfies the requirement mcp (from versions: none)
ERROR: No matching distribution found for mcp

Also tried this with VirtualEnv

pip install praisonaiagents mcp
Requirement already satisfied: praisonaiagents in ./lib/python3.9/site-packages (0.0.67)
ERROR: Could not find a version that satisfies the requirement mcp (from versions: none)
ERROR: No matching distribution found for mcp

[MervinPraison]

@d4rk8l1tz

Not sure if you are using the correct python version

https://pypi.org/project/mcp/

It requires minimum of 3.10

[jbfenris]

Hi,
same issue using uv
I have installed mcp and praisonaigents separately (see below) but the following error occured:

ImportError: cannot import name 'MCP' from partially initialized module 'praisonaiagents.mcp' (most likely due to a circular import) (/Users/x/Documents/code/mcp-ollama/.venv/lib/python3.13/site-packages/praisonaiagents/mcp/init.py)

uv add mcp                                                                                                        
Resolved 22 packages in 171ms
Installed 20 packages in 614ms
 + annotated-types==0.7.0
 + anyio==4.9.0
 + certifi==2025.1.31
 + click==8.1.8
 + h11==0.14.0
 + httpcore==1.0.7
 + httpx==0.28.1
 + httpx-sse==0.4.0
 + idna==3.10
 + mcp==1.6.0
 + pydantic==2.11.1
 + pydantic-core==2.33.0
 + pydantic-settings==2.8.1
 + python-dotenv==1.1.0
 + sniffio==1.3.1
 + sse-starlette==2.2.1
 + starlette==0.46.1
 + typing-extensions==4.13.0
 + typing-inspection==0.4.0
 + uvicorn==0.34.0

uv add praisonaiagents                                                                                  
Resolved 31 packages in 258ms
Prepared 1 package in 51ms
Installed 9 packages in 199ms
 + distro==1.9.0
 + jiter==0.9.0
 + markdown-it-py==3.0.0
 + mdurl==0.1.2
 + openai==1.70.0
 + praisonaiagents==0.0.73
 + pygments==2.19.1
 + rich==14.0.0
 + tqdm==4.67.1

[d4rk8l1tz]

@d4rk8l1tz

Not sure if you are using the correct python version

https://pypi.org/project/mcp/

It requires minimum of 3.10

This was it for me. Did have python 3.10 but the venv got created with 3.9.
thank you so much

[jbfenris]

Testing with 3.10 or 3.13 and I got the same error

ImportError: cannot import name 'MCP' from partially initialized module 'praisonaiagents.mcp' (most likely due to a circular import) (/Users/x/Documents/code/mcp-ollama/.venv/lib/python3.10/site-packages/praisonaiagents/mcp/init.py)

ImportError: cannot import name 'MCP' from partially initialized module 'praisonaiagents.mcp' (most likely due to a circular import) (/Users/x/Documents/code/mcp-ollama/.venv/lib/python3.13/site-packages/praisonaiagents/mcp/init.py)

[MervinPraison]

@jbfenris Did you try upgrading like this

pip install -U "praisonaiagents[mcp]"

Also try like this

conda create -n praisonai python=3.11 -y
conda activate praisonai
pip install -U praisonaiagents mcp

[jbfenris]

Same result :(
I use python 3.11, force to reinstall environnement and package without cache but the same error is there:

ImportError: cannot import name 'MCP' from partially initialized module 'praisonaiagents.mcp' (most likely due to a circular import) (/Users/x/Documents/code/mcp-ollama/.venv/lib/python3.11/site-packages/praisonaiagents/mcp/init.py)

May it come from macOS ?

[MervinPraison]

@jbfenris Please trying using conda instead of .venv and let me know. This issue is resolved for @d4rk8l1tz

I can see your version uses .venv

/Users/x/Documents/code/mcp-ollama/.venv

Conda

conda create -n praisonai python=3.11 -y
conda activate praisonai
pip install -U praisonaiagents mcp

[jbfenris]

Hi,
I confirm it works now using conda and the latest version of your library.

For venv, I still got the following error.

I attach the list of library and version installed in the environment:
package llist venv.txt

────────────────────────── Traceback (most recent call last) ───────────────────────────
  /Users/x/Documents/code/rag-ollama/.venv/lib/python3.13/site-packages/streamlit/ru
  ntime/scriptrunner/exec_code.py:121 in exec_func_with_error_handling

  /Users/x/Documents/code/rag-ollama/.venv/lib/python3.13/site-packages/streamlit/ru
  ntime/scriptrunner/script_runner.py:640 in code_to_exec

  /Users/x/Documents/code/rag-ollama/main.py:2 in <module>

     1 import streamlit as st
  ❱  2 from praisonaiagents import Agent
     3
     4 def init_agent():
     5 │   config = {

  /Users/x/Documents/code/rag-ollama/.venv/lib/python3.13/site-packages/praisonaiage
  nts/__init__.py:13 in <module>

    10 from .agents.autoagents import AutoAgents
    11 from .knowledge.knowledge import Knowledge
    12 from .knowledge.chunking import Chunking
  ❱ 13 from .mcp.mcp import MCP
    14 from .main import (
    15 │   TaskOutput,
    16 │   ReflectionOutput,

  /Users/x/Documents/code/rag-ollama/.venv/lib/python3.13/site-packages/praisonaiage
  nts/mcp/__init__.py:4 in <module>

    1 """
    2 Model Context Protocol (MCP) integration for PraisonAI Agents.
    3 """
  ❱ 4 from .mcp import MCP
    5
    6 __all__ = ["MCP"]
    7

  /Users/x/Documents/code/rag-ollama/.venv/lib/python3.13/site-packages/praisonaiage
  nts/mcp/mcp.py:12 in <module>

      9 from typing import Any, List, Optional, Callable, Iterable, Union
     10 from functools import wraps, partial
     11
  ❱  12 from mcp import ClientSession, StdioServerParameters
     13 from mcp.client.stdio import stdio_client
     14
     15 class MCPToolRunner(threading.Thread):

  /Users/jbh/Documents/code/rag-ollama/mcp.py:1 in <module>

  ❱  1 from praisonaiagents import Agent, MCP
     2
     3 search_agent = Agent(
     4 │   instructions="""You help book apartments on Airbnb.""",
────────────────────────────────────────────────────────────────────────────────────────
ImportError: cannot import name 'MCP' from partially initialized module
'praisonaiagents' (most likely due to a circular import)
(/Users/x/Documents/code/rag-ollama/.venv/lib/python3.13/site-packages/praisonaiagents
/__init__.py)

[MervinPraison]

@jbfenris Can you please test this and let me know? I could see the latest version is working fine.

[MervinPraison]

@d4rk8l1tz @jbfenris Please reopen this issue if this still persists. Please test and let me know. Thanks for your contribution.