Refactor MCP server with modular architecture and stateless HTTP support

Major refactoring to improve code organization, testing, and HTTP transport:

- Fix stateless HTTP mode by moving stateless_http parameter to run() method
- Extract tools into separate modules (chat.py, search.py, datasources.py)
- Add comprehensive test suite (76% coverage with 27 passing tests)
- Implement XML response transformer for 60-90% token reduction in search results
- Add shared error handling utilities and data source conversion helpers
- Create modular core components (client.py, config.py, logging.py)
- Simplify chat API to accept string IDs instead of complex objects
- Add request ID tracing for better debugging
- Clean up unnecessary files and comments
- Add .mcp.json to .gitignore for local configuration

This refactoring improves maintainability, reduces code duplication from ~1140 lines,
and ensures the server works reliably with both stdio and stateless HTTP transports.

Author: IvanBiruk

.gitignore

@@ -178,3 +178,6 @@ cython_debug/
 
 # JetBrains IDE
 .idea/
+
+# MCP configuration file
+.mcp.json

Dockerfile

@@ -10,15 +10,12 @@ RUN apt-get update \
     && apt-get install -y --no-install-recommends gcc libssl-dev \
     && rm -rf /var/lib/apt/lists/*
 
-# Install Python dependencies
-RUN pip install --no-cache-dir \
-    fastmcp>=2.0.0 \
-    httpx>=0.26.0 \
-    python-dotenv>=1.0.0
-
-# Copy application code
+# Copy application code first
 COPY . /app
 
+# Install the package using pyproject.toml
+RUN pip install --no-cache-dir -e .
+
 # Expose port for HTTP transport
 EXPOSE 8000
 

pyproject.toml

@@ -3,12 +3,19 @@ name = "codealive-mcp"
 version = "0.2.0"
 description = "MCP server for the CodeAlive API"
 readme = "README.md"
-requires-python = "~=3.11.0"
+requires-python = ">=3.11"
 dependencies = [
-    "fastmcp>=2.0.0",
-    "httpx>=0.26.0",
-    "python-dotenv>=1.0.0",
-    "loguru>=0.7.0",
+    "fastmcp==2.12.3",
+    "httpx==0.28.1",
+    "python-dotenv==1.1.1",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest==8.3.6",
+    "pytest-asyncio==0.25.2",
+    "pytest-mock==3.15.0",
+    "pytest-cov==6.0.0",
 ]
 
 [project.scripts]
@@ -20,4 +27,4 @@ build-backend = "setuptools.build_meta"
 
 [tool.setuptools]
 packages = ["src"]
-package-dir = {"" = "."} 
+package-dir = {"" = "."}