Update README.md and tests for resource URI changes; bump version to 0.9.1 and add pyyaml dependency

Author: abhishekbhakat

README.md

@@ -148,7 +148,7 @@ Point the server at a folder of Markdown guides whenever you want agents to refe
 airflow-mcp-server --base-url http://localhost:8080 --auth-token <jwt> --resources-dir ~/airflow-resources
 ```
 
-- Every top-level `.md`/`.markdown` file becomes a read-only resource (`resource://knowledge/<slug>`) visible in your MCP client.
+- Every top-level `.md`/`.markdown` file becomes a read-only resource (`file:///<slug>`) visible in your MCP client.
 - The first `# Heading` in each file (if present) is used as the resource title; otherwise the filename stem is used.
 - Set `AIRFLOW_MCP_RESOURCES_DIR=/path/to/docs` if you prefer environment-based configuration.
 - Update the files on disk and restart the server to refresh the resources list.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "airflow-mcp-server"
-version = "0.9.0"
+version = "0.9.1"
 description = "MCP Server for Airflow"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -13,6 +13,7 @@ dependencies = [
     "uvicorn>=0.30.0",
     "starlette>=0.37.0",
     "click>=8.3.0",
+    "pyyaml>=6.0.3",
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",

src/airflow_mcp_server/knowledge_resources.py

@@ -118,13 +118,13 @@ def load_knowledge_resources(resources_dir: str | None) -> list[tuple[str, str,
     for markdown_file in _iter_markdown_files(root_resolved):
         relative_name = markdown_file.stem
         slug = _unique_slug(_slugify(relative_name), slugs)
-        uri = f"resource://knowledge/{slug}"
+        uri = f"file:///{slug}"
         title = _extract_title(markdown_file)
 
         display_title = title or relative_name.replace("_", " ").strip()
 
         discovered.append((uri, display_title, lambda p=markdown_file: _read_file(p), "text/markdown"))
-        logger.debug("Registered knowledge resource %s for %s", uri, markdown_file)
+        logger.debug("Registered resource %s for %s", uri, markdown_file)
 
     if not discovered:
         logger.info("Resources directory contained no Markdown files: %s", resources_dir)

tests/test_knowledge_resources.py

@@ -17,8 +17,8 @@ def test_registers_markdown_files(tmp_path: Path):
     resources = load_knowledge_resources(str(tmp_path))
     contents = _materialize(resources)
 
-    assert "resource://knowledge/guide" in contents
-    assert contents["resource://knowledge/guide"] == "# Title\nBody"
+    assert "file:///guide" in contents
+    assert contents["file:///guide"] == "# Title\nBody"
 
 
 def test_duplicate_names_get_unique_slugs(tmp_path: Path):
@@ -29,10 +29,10 @@ def test_duplicate_names_get_unique_slugs(tmp_path: Path):
     resources = load_knowledge_resources(str(tmp_path))
     contents = _materialize(resources)
 
-    assert "resource://knowledge/note" in contents
-    assert "resource://knowledge/note-2" in contents
-    assert contents["resource://knowledge/note"] == "first"
-    assert contents["resource://knowledge/note-2"] == "second"
+    assert "file:///note" in contents
+    assert "file:///note-2" in contents
+    assert contents["file:///note"] == "first"
+    assert contents["file:///note-2"] == "second"
 
 
 def test_missing_directory_logs_warning(caplog):