merged

main.py

@@ -1,6 +1,5 @@
 import os
 import pprint
-from typing import Literal
 import uuid
 from dotenv import load_dotenv
 
@@ -10,7 +9,6 @@ from langgraph.prebuilt import ToolNode
 from langgraph.graph import MessagesState, END, StateGraph
 from langchain_core.messages import HumanMessage
 from langgraph.checkpoint.memory import MemorySaver
-from langgraph.types import Command
 
 
 from pmcp.agents.executor import ExecutorAgent

pmcp/mcp_server/github_server/connection_test.py

@@ -0,0 +1,14 @@
+from fastmcp import Client
+
+async def main():
+    # Connect via stdio to a local script
+    async with Client("mcp_github_main.py") as client:
+        tools = await client.list_tools()
+        print(f"Available tools: {tools}")
+        result = await client.call_tool("get_issues", {"owner":"jlowin", "repo":"fastmcp"})
+        print(f"Result: {result}")
+
+
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(main())

pmcp/mcp_server/{github → github_server}/github.py

@@ -2,13 +2,13 @@ import os
 
 from dotenv import load_dotenv
 
-from pmcp.mcp_server.github.utils.github_api import GithubClient
+from pmcp.mcp_server.github_server.utils.github_api import GithubClient
 
 
 # Load environment variables
 load_dotenv()
 
-
+client = None
 # Initialize Github client and service
 try:
     api_key = os.getenv("GITHUB_API_KEY")

pmcp/mcp_server/{github → github_server}/mcp_github_main.py

@@ -3,7 +3,7 @@ import logging
 from dotenv import load_dotenv
 from mcp.server.fastmcp import FastMCP
 
-from pmcp.mcp_server.github.tools.tools import register_tools
+from pmcp.mcp_server.github_server.tools.tools import register_tools
 
 # Configure logging
 logging.basicConfig(
@@ -22,7 +22,6 @@ mcp = FastMCP("Github MCP Server")
 register_tools(mcp)
 
 
-
 if __name__ == "__main__":
     try:
         logger.info("Starting Github MCP Server in Stdio...")

pmcp/mcp_server/{github → github_server}/services/branches.py

@@ -1,4 +1,4 @@
-from pmcp.mcp_server.github.utils.github_api import GithubClient
+from pmcp.mcp_server.github_server.utils.github_api import GithubClient
 
 
 class BranchService:

pmcp/mcp_server/{github → github_server}/services/repo.py

@@ -1,4 +1,4 @@
-from pmcp.mcp_server.github.utils.github_api import GithubClient
+from pmcp.mcp_server.github_server.utils.github_api import GithubClient
 
 
 class RepoService:

pmcp/mcp_server/{github → github_server}/tools/branches.py

@@ -3,8 +3,8 @@ Branch listing tool.
 """
 from typing import List, Dict
 from mcp.server.fastmcp import Context
-from pmcp.mcp_server.github.services.branches import BranchService
-from pmcp.mcp_server.github import client
+from pmcp.mcp_server.github_server.services.branches import BranchService
+from pmcp.mcp_server.github_server.github import client
 
 service = BranchService(client)
 

pmcp/mcp_server/{github → github_server}/tools/contents.py

@@ -4,8 +4,8 @@ Commit and file-content tools.
 import base64
 from typing import List, Dict
 from mcp.server.fastmcp import Context
-from pmcp.mcp_server.github.services.contents import ContentService
-from pmcp.mcp_server.github import client
+from pmcp.mcp_server.github_server.services.contents import ContentService
+from pmcp.mcp_server.github_server.github import client
 
 service = ContentService(client)
 

pmcp/mcp_server/{github → github_server}/tools/issues.py

@@ -4,8 +4,8 @@ MCP Tools exposing GitHub issue operations.
 from typing import List, Dict, Any
 from mcp.server.fastmcp import Context
 
-from pmcp.mcp_server.github.services.issues import IssueService
-from pmcp.mcp_server.github import client
+from pmcp.mcp_server.github_server.services.issues import IssueService
+from pmcp.mcp_server.github_server.github import client
 
 
 service = IssueService(client)

pmcp/mcp_server/{github → github_server}/tools/pull_requests.py

@@ -3,8 +3,8 @@ Pull-request utilities (read-only).
 """
 from typing import List, Dict
 from mcp.server.fastmcp import Context
-from pmcp.mcp_server.github.services.pull_requests import PullRequestService
-from pmcp.mcp_server.github import client
+from pmcp.mcp_server.github_server.services.pull_requests import PullRequestService
+from pmcp.mcp_server.github_server.github import client
 
 service = PullRequestService(client)
 

pmcp/mcp_server/{github → github_server}/tools/repo.py

@@ -2,8 +2,8 @@
 Repository-level stats tool.
 """
 from mcp.server.fastmcp import Context
-from pmcp.mcp_server.github.services.repo import RepoService
-from pmcp.mcp_server.github import client
+from pmcp.mcp_server.github_server.services.repo import RepoService
+from pmcp.mcp_server.github_server.github import client
 
 
 service = RepoService(client)

pmcp/mcp_server/{github → github_server}/tools/repo_to_text.py

@@ -2,8 +2,8 @@
 This module contains tools for managing Github.
 """
 
-from pmcp.mcp_server.github.services.repo_to_text import RepoToTextService
-from pmcp.mcp_server.github import client
+from pmcp.mcp_server.github_server.services.repo_to_text import RepoToTextService
+from pmcp.mcp_server.github_server.github import client
 
 from mcp.server.fastmcp import Context
 

pmcp/mcp_server/{github → github_server}/tools/tools.py

@@ -2,7 +2,7 @@
 This module contains tools for managing Github Issues
 """
 
-from pmcp.mcp_server.github.tools import issues, pull_requests, repo, repo_to_text,branches, contents
+from pmcp.mcp_server.github_server.tools import issues, pull_requests, repo, repo_to_text,branches, contents
 
 
 def register_tools(mcp):

pmcp/mcp_server/{github → github_server}/utils/github_api.py

@@ -1,6 +1,6 @@
 import logging
 import httpx
-from pmcp.mcp_server.github.utils.repo_to_text_utils import fetch_file_contents, fetch_repo_sha, fetch_repo_tree, format_repo_contents, parse_repo_url
+from pmcp.mcp_server.github_server.utils.repo_to_text_utils import fetch_file_contents, fetch_repo_sha, fetch_repo_tree, format_repo_contents, parse_repo_url
 
 
 GITHUB_API_BASE = "https://api.github.com/repos"

pmcp/mcp_server/trello_server/connection_test.py

@@ -0,0 +1,14 @@
+from fastmcp import Client
+
+async def main():
+    # Connect via stdio to a local script
+    async with Client("mcp_trello_main.py") as client:
+        tools = await client.list_tools()
+        print(f"Available tools: {tools}")
+        result = await client.call_tool("get_boards")
+        print(f"Result: {result}")
+
+
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(main())

pmcp/mcp_server/{trello → trello_server}/mcp_trello_main.py

@@ -3,7 +3,7 @@ import logging
 from dotenv import load_dotenv
 from mcp.server.fastmcp import FastMCP
 
-from pmcp.mcp_server.trello.tools.tools import register_tools
+from pmcp.mcp_server.trello_server.tools.tools import register_tools
 
 # Configure logging
 logging.basicConfig(
@@ -27,7 +27,7 @@ if __name__ == "__main__":
     try:
         logger.info("Starting Trello MCP Server in Stdio...")
         mcp.run()
-        logger.info("Github MCP Server started successfully")
+        logger.info("Trello MCP Server started successfully")
     except KeyboardInterrupt:
         logger.info("Shutting down server...")
     except Exception as e:

pmcp/mcp_server/{trello → trello_server}/services/board.py

@@ -4,8 +4,8 @@ Service for managing Trello boards in MCP server.
 
 from typing import List
 
-from pmcp.mcp_server.trello.models import TrelloBoard, TrelloLabel
-from pmcp.mcp_server.trello.utils.trello_api import TrelloClient
+from pmcp.mcp_server.trello_server.models import TrelloBoard, TrelloLabel
+from pmcp.mcp_server.trello_server.utils.trello_api import TrelloClient
 
 
 class BoardService:

pmcp/mcp_server/{trello → trello_server}/services/card.py

@@ -4,8 +4,8 @@ Service for managing Trello cards in MCP server.
 
 from typing import Any, Dict, List
 
-from pmcp.mcp_server.trello.models import TrelloCard
-from pmcp.mcp_server.trello.utils.trello_api import TrelloClient
+from pmcp.mcp_server.trello_server.models import TrelloCard
+from pmcp.mcp_server.trello_server.utils.trello_api import TrelloClient
 
 
 class CardService:

pmcp/mcp_server/{trello → trello_server}/services/checklist.py

@@ -1,7 +1,7 @@
 import logging
 from typing import Dict, List, Optional
 
-from pmcp.mcp_server.trello.utils.trello_api import TrelloClient
+from pmcp.mcp_server.trello_server.utils.trello_api import TrelloClient
 
 
 class ChecklistService:

pmcp/mcp_server/{trello → trello_server}/services/list.py

@@ -1,7 +1,7 @@
 from typing import List
 
-from pmcp.mcp_server.trello.models import TrelloList
-from pmcp.mcp_server.trello.utils.trello_api import TrelloClient
+from pmcp.mcp_server.trello_server.models import TrelloList
+from pmcp.mcp_server.trello_server.utils.trello_api import TrelloClient
 
 
 class ListService:

pmcp/mcp_server/{trello → trello_server}/tools/board.py

@@ -7,9 +7,9 @@ from typing import List
 
 from mcp.server.fastmcp import Context
 
-from pmcp.mcp_server.trello.models import TrelloBoard, TrelloLabel
-from pmcp.mcp_server.trello.services.board import BoardService
-from pmcp.mcp_server.trello.trello import client
+from pmcp.mcp_server.trello_server.models import TrelloBoard, TrelloLabel
+from pmcp.mcp_server.trello_server.services.board import BoardService
+from pmcp.mcp_server.trello_server.trello import client
 
 
 
@@ -36,6 +36,7 @@ async def get_board(ctx: Context, board_id: str) -> TrelloBoard:
 
 async def get_boards(ctx: Context) -> List[TrelloBoard]:
     """Retrieves all boards for the authenticated user.
+    Use this method when the user specify only the Board Name and you have to retrieve the Board ID.
 
     Returns:
         List[TrelloBoard]: A list of board objects.

pmcp/mcp_server/{trello → trello_server}/tools/card.py

@@ -7,10 +7,10 @@ from typing import List
 
 from mcp.server.fastmcp import Context
 
-from pmcp.mcp_server.trello.models import TrelloCard
-from pmcp.mcp_server.trello.services.card import CardService
-from pmcp.mcp_server.trello.trello import client
-from pmcp.mcp_server.trello.dtos.update_card import UpdateCardPayload
+from pmcp.mcp_server.trello_server.models import TrelloCard
+from pmcp.mcp_server.trello_server.services.card import CardService
+from pmcp.mcp_server.trello_server.trello import client
+from pmcp.mcp_server.trello_server.dtos.update_card import UpdateCardPayload
 
 
 service = CardService(client)

pmcp/mcp_server/{trello → trello_server}/tools/checklist.py

@@ -5,8 +5,8 @@ This module contains tools for managing Trello checklists.
 import logging
 from typing import Dict, List, Optional
 
-from pmcp.mcp_server.trello.services.checklist import ChecklistService
-from pmcp.mcp_server.trello.trello import client
+from pmcp.mcp_server.trello_server.services.checklist import ChecklistService
+from pmcp.mcp_server.trello_server.trello import client
 
 service = ChecklistService(client)
 

pmcp/mcp_server/{trello → trello_server}/tools/list.py

@@ -7,9 +7,9 @@ from typing import List
 
 from mcp.server.fastmcp import Context
 
-from pmcp.mcp_server.trello.models import TrelloList
-from pmcp.mcp_server.trello.services.list import ListService
-from pmcp.mcp_server.trello.trello import client
+from pmcp.mcp_server.trello_server.models import TrelloList
+from pmcp.mcp_server.trello_server.services.list import ListService
+from pmcp.mcp_server.trello_server.trello import client
 
 
 

pmcp/mcp_server/{trello → trello_server}/tools/tools.py

@@ -2,7 +2,7 @@
 This module contains tools for managing Trello boards, lists, and cards.
 """
 
-from pmcp.mcp_server.trello.tools import board, card, checklist, list
+from pmcp.mcp_server.trello_server.tools import board, card, checklist, list
 
 
 def register_tools(mcp):

pmcp/mcp_server/{trello → trello_server}/trello.py

@@ -3,7 +3,7 @@ import os
 
 from dotenv import load_dotenv
 
-from pmcp.mcp_server.trello.utils.trello_api import TrelloClient
+from pmcp.mcp_server.trello_server.utils.trello_api import TrelloClient
 
 
 # Load environment variables

pyproject.toml

@@ -15,6 +15,7 @@ dependencies = [
     "httpx>=0.28.1",
     "requests>=2.32.3",
     "grandalf>=0.8",
+    "fastmcp>=2.5.2",
 ]
 
 [dependency-groups]

uv.lock

@@ -324,6 +324,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/bf/6c/e36d22e76f4aa4e1ea7ea9b443bd49b5ffd2f13d430840f47e35284f797a/duckduckgo_search-8.0.2-py3-none-any.whl", hash = "sha256:b5ff8b6b8f169b8e1b15a788a5749aa900ebcefd6e1ab485787582f8d5b4f1ef", size = 18184, upload-time = "2025-05-15T08:43:23.713Z" },
 ]
 
+[[package]]
+name = "exceptiongroup"
+version = "1.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/0b/9f/a65090624ecf468cdca03533906e7c69ed7588582240cfe7cc9e770b50eb/exceptiongroup-1.3.0.tar.gz", hash = "sha256:b241f5885f560bc56a59ee63ca4c6a8bfa46ae4ad651af316d4e81817bb9fd88", size = 29749, upload-time = "2025-05-10T17:42:51.123Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/36/f4/c6e662dade71f56cd2f3735141b265c3c79293c109549c1e6933b0651ffc/exceptiongroup-1.3.0-py3-none-any.whl", hash = "sha256:4d111e6e0c13d0644cad6ddaa7ed0261a0b36971f6d23e7ec9b4b9097da78a10", size = 16674, upload-time = "2025-05-10T17:42:49.33Z" },
+]
+
 [[package]]
 name = "fastapi"
 version = "0.115.12"
@@ -338,6 +350,25 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/50/b3/b51f09c2ba432a576fe63758bddc81f78f0c6309d9e5c10d194313bf021e/fastapi-0.115.12-py3-none-any.whl", hash = "sha256:e94613d6c05e27be7ffebdd6ea5f388112e5e430c8f7d6494a9d1d88d43e814d", size = 95164, upload-time = "2025-03-23T22:55:42.101Z" },
 ]
 
+[[package]]
+name = "fastmcp"
+version = "2.5.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "exceptiongroup" },
+    { name = "httpx" },
+    { name = "mcp" },
+    { name = "openapi-pydantic" },
+    { name = "python-dotenv" },
+    { name = "rich" },
+    { name = "typer" },
+    { name = "websockets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/20/cc/d2c0e63d2b34681bef4e077611dae662ea722add13a83dc4ae08b6e0fd23/fastmcp-2.5.2.tar.gz", hash = "sha256:761c92fb54f561136f631d7d98b4920152978f6f0a66a4cef689a7983fd05c8b", size = 1039189, upload-time = "2025-05-29T18:11:33.088Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3e/ac/caa94ff747e2136829ac2fea33b9583e086ca5431451751bcb2f773e087f/fastmcp-2.5.2-py3-none-any.whl", hash = "sha256:4ea46ef35c1308b369eff7c8a10e4c9639bed046fd646449c1227ac7c3856d83", size = 107502, upload-time = "2025-05-29T18:11:31.577Z" },
+]
+
 [[package]]
 name = "ffmpy"
 version = "0.5.0"
@@ -1172,6 +1203,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a8/d9/7ec61c010f0d0b0bc57dab8b8dff398f84230d269e8bfa068ad542ff050c/openai-1.82.1-py3-none-any.whl", hash = "sha256:334eb5006edf59aa464c9e932b9d137468d810b2659e5daea9b3a8c39d052395", size = 720466, upload-time = "2025-05-29T16:15:12.531Z" },
 ]
 
+[[package]]
+name = "openapi-pydantic"
+version = "0.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/02/2e/58d83848dd1a79cb92ed8e63f6ba901ca282c5f09d04af9423ec26c56fd7/openapi_pydantic-0.5.1.tar.gz", hash = "sha256:ff6835af6bde7a459fb93eb93bb92b8749b754fc6e51b2f1590a19dc3005ee0d", size = 60892, upload-time = "2025-01-08T19:29:27.083Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" },
+]
+
 [[package]]
 name = "orjson"
 version = "3.10.18"
@@ -1332,6 +1375,7 @@ name = "pmcp"
 version = "0.1.0"
 source = { virtual = "." }
 dependencies = [
+    { name = "fastmcp" },
     { name = "gradio", extra = ["mcp"] },
     { name = "grandalf" },
     { name = "httpx" },
@@ -1352,6 +1396,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
+    { name = "fastmcp", specifier = ">=2.5.2" },
     { name = "gradio", extras = ["mcp"], specifier = ">=5.32.0" },
     { name = "grandalf", specifier = ">=0.8" },
     { name = "httpx", specifier = ">=0.28.1" },