docpull 3.0.1__tar.gz → 3.0.2__tar.gz

{docpull-3.0.1/src/docpull.egg-info → docpull-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docpull
-Version: 3.0.1
+Version: 3.0.2
 Summary: Pull documentation from the web and convert to clean markdown
 Author-email: Zachary Roth <support@raintree.technology>
 Maintainer-email: Raintree Technology <support@raintree.technology>
@@ -228,12 +228,19 @@ pip install 'docpull[mcp]'
 docpull mcp  # starts the stdio server
 ```
 
-Add to Claude Desktop or Claude Code manually:
+Claude Code:
+
+```bash
+claude mcp add --transport stdio docpull -- docpull mcp
+```
+
+Cursor (`.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` globally):
 
 ```json
 {
   "mcpServers": {
     "docpull": {
+      "type": "stdio",
       "command": "docpull",
       "args": ["mcp"]
     }
@@ -241,6 +248,9 @@ Add to Claude Desktop or Claude Code manually:
 }
 ```
 
+Claude Desktop uses the same `mcpServers` shape in
+`claude_desktop_config.json`.
+
 Or, if you use Claude Code, install the plugin instead — it bundles the MCP
 server, five slash commands (`/docs-add`, `/docs-search`, `/docs-list`,
 `/docs-refresh`, `/docs-remove`), and a meta-skill that teaches Claude

{docpull-3.0.1 → docpull-3.0.2}/README.md

@@ -140,12 +140,19 @@ pip install 'docpull[mcp]'
 docpull mcp  # starts the stdio server
 ```
 
-Add to Claude Desktop or Claude Code manually:
+Claude Code:
+
+```bash
+claude mcp add --transport stdio docpull -- docpull mcp
+```
+
+Cursor (`.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` globally):
 
 ```json
 {
   "mcpServers": {
     "docpull": {
+      "type": "stdio",
       "command": "docpull",
       "args": ["mcp"]
     }
@@ -153,6 +160,9 @@ Add to Claude Desktop or Claude Code manually:
 }
 ```
 
+Claude Desktop uses the same `mcpServers` shape in
+`claude_desktop_config.json`.
+
 Or, if you use Claude Code, install the plugin instead — it bundles the MCP
 server, five slash commands (`/docs-add`, `/docs-search`, `/docs-list`,
 `/docs-refresh`, `/docs-remove`), and a meta-skill that teaches Claude

{docpull-3.0.1 → docpull-3.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "docpull"
-version = "3.0.1"
+version = "3.0.2"
 dynamic = []
 description = "Pull documentation from the web and convert to clean markdown"
 readme = {file = "README.md", content-type = "text/markdown"}

{docpull-3.0.1 → docpull-3.0.2}/src/docpull/__init__.py

@@ -14,7 +14,7 @@ Usage:
             print(event)
 """
 
-__version__ = "3.0.0"
+__version__ = "3.0.2"
 
 from .cache import CacheManager, StreamingDeduplicator
 from .conversion.chunking import Chunk, TokenCounter, chunk_markdown

{docpull-3.0.1 → docpull-3.0.2/src/docpull.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docpull
-Version: 3.0.1
+Version: 3.0.2
 Summary: Pull documentation from the web and convert to clean markdown
 Author-email: Zachary Roth <support@raintree.technology>
 Maintainer-email: Raintree Technology <support@raintree.technology>
@@ -228,12 +228,19 @@ pip install 'docpull[mcp]'
 docpull mcp  # starts the stdio server
 ```
 
-Add to Claude Desktop or Claude Code manually:
+Claude Code:
+
+```bash
+claude mcp add --transport stdio docpull -- docpull mcp
+```
+
+Cursor (`.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` globally):
 
 ```json
 {
   "mcpServers": {
     "docpull": {
+      "type": "stdio",
       "command": "docpull",
       "args": ["mcp"]
     }
@@ -241,6 +248,9 @@ Add to Claude Desktop or Claude Code manually:
 }
 ```
 
+Claude Desktop uses the same `mcpServers` shape in
+`claude_desktop_config.json`.
+
 Or, if you use Claude Code, install the plugin instead — it bundles the MCP
 server, five slash commands (`/docs-add`, `/docs-search`, `/docs-list`,
 `/docs-refresh`, `/docs-remove`), and a meta-skill that teaches Claude

{docpull-3.0.1 → docpull-3.0.2}/src/docpull.egg-info/SOURCES.txt

@@ -75,6 +75,7 @@ tests/test_convert_step_new.py
 tests/test_discovery.py
 tests/test_integration.py
 tests/test_link_extractors.py
+tests/test_mcp_server.py
 tests/test_mcp_tools.py
 tests/test_naming.py
 tests/test_pipeline.py

{docpull-3.0.1 → docpull-3.0.2}/tests/test_cli.py

@@ -1,10 +1,17 @@
 """CLI regression tests."""
 
+from importlib.metadata import version
+
 import pytest
 
+import docpull
 from docpull.cli import create_parser
 
 
+def test_runtime_version_matches_package_metadata():
+    assert docpull.__version__ == version("docpull")
+
+
 def test_parser_rejects_removed_js_flag():
     """Ensure the removed JavaScript flag stays unavailable."""
     parser = create_parser()

docpull-3.0.2/tests/test_mcp_server.py

@@ -0,0 +1,51 @@
+"""End-to-end tests for the stdio MCP server."""
+
+from __future__ import annotations
+
+import os
+import sys
+
+import pytest
+
+pytest.importorskip("mcp")
+pytest.importorskip("mcp.client.stdio")
+
+from mcp.client.stdio import stdio_client
+
+from mcp import ClientSession, StdioServerParameters
+
+
+@pytest.mark.asyncio
+async def test_stdio_server_lists_and_calls_tools(tmp_path):
+    env = os.environ.copy()
+    env["XDG_CONFIG_HOME"] = str(tmp_path / "config")
+    env["XDG_DATA_HOME"] = str(tmp_path / "data")
+
+    server = StdioServerParameters(
+        command=sys.executable,
+        args=["-m", "docpull", "mcp"],
+        env=env,
+    )
+    async with stdio_client(server) as (read, write), ClientSession(read, write) as session:
+        await session.initialize()
+
+        tools = await session.list_tools()
+        names = {tool.name for tool in tools.tools}
+        assert names == {
+            "fetch_url",
+            "ensure_docs",
+            "list_sources",
+            "list_indexed",
+            "grep_docs",
+            "read_doc",
+            "add_source",
+            "remove_source",
+        }
+
+        result = await session.call_tool("list_sources", {})
+        assert result.isError is False
+        assert result.structuredContent is not None
+        assert any(source["name"] == "react" for source in result.structuredContent["sources"])
+
+        rejected = await session.call_tool("fetch_url", {"url": "https://localhost/admin"})
+        assert rejected.isError is True