import logging import os from pathlib import Path from mcp.server import MCPServer logging.basicConfig(level=logging.DEBUG) logger = logging.getLogger(__name__) ROOT = Path( os.environ.get("KNOWLEDGE_ROOT", "/knowledge") ).resolve() mcp = MCPServer( "Engineering Knowledge", log_level="DEBUG" ) logger.info("Knowledge root: %s", ROOT) @mcp.tool() def list_notes() -> list[str]: logger.info("list_notes called") files = [ str(p.relative_to(ROOT)) for p in ROOT.rglob("*.md") ] logger.info("Found %d notes", len(files)) return files @mcp.tool() def search_knowledge(query: str) -> list[dict]: logger.info( "Searching knowledge for: %s", query ) results = [] for file in ROOT.rglob("*.md"): text = file.read_text( encoding="utf-8", errors="ignore" ) if query.lower() in text.lower(): results.append({ "path": str(file.relative_to(ROOT)), "preview": text[:500] }) logger.info( "Search returned %d results", len(results) ) return results[:20] if __name__ == "__main__": logger.info("Starting MCP server") mcp.run( transport="streamable-http", host="0.0.0.0", port=8000 )