Release v0.2.2

- Remove misleading default values for docset parameters
- Make language parameter optional with smart defaults based on docset config
- Fix markdown rendering issues with bold text in HTML summary tags
- Add Kapeli to spell check dictionary
- Improve documentation accuracy in README

Breaking changes:
- `search_docs` now requires `docset` parameter (no default)
- `list_frameworks` now requires `docset` parameter (no default)

Author: codybrom

.cspell.json

@@ -18,6 +18,7 @@
     "intfp",
     "joomla",
     "jqueryui",
+    "Kapeli",
     "kobold",
     "lgblock",
     "lgwin",

.vscode/settings.json

@@ -19,6 +19,7 @@
             "allowed_elements": [
                 "details",
                 "summary",
+                "b"
             ]
         }
     },

README.md

@@ -73,7 +73,7 @@ Add to your MCP config and restart your MCP client. Then try asking something li
 DocsetMCP supports 165+ docsets including:
 
 <details>
-<summary>**Popular Languages**</summary>
+<summary><b>Popular Languages</b></summary>
 
 - Python (2 & 3)
 - JavaScript / TypeScript
@@ -90,7 +90,7 @@ DocsetMCP supports 165+ docsets including:
 </details>
 
 <details>
-<summary>**Web Frameworks**</summary>
+<summary><b>Web Frameworks</b></summary>
 
 - React / Angular / Vue
 - Node.js / Express
@@ -103,7 +103,7 @@ DocsetMCP supports 165+ docsets including:
 </details>
 
 <details>
-<summary>**Developer Tools**</summary>
+<summary><b>Developer Tools</b></summary>
 
 - Git (cheatsheet)
 - Docker (cheatsheet)
@@ -130,7 +130,7 @@ Use `list_available_docsets` to see all docsets installed on your system.
 Choose your MCP client below for specific setup instructions:
 
 <details>
-<summary>**🤖 Claude Desktop**</summary>
+<summary><b>🤖 Claude Desktop</b></summary>
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
@@ -148,7 +148,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 </details>
 
 <details>
-<summary>**⌨️ Claude Code CLI**</summary>
+<summary><b>⌨️ Claude Code CLI</b></summary>
 
 ```bash
 # For current project
@@ -161,7 +161,7 @@ claude mcp add --scope user docsetmcp "uvx docsetmcp"
 </details>
 
 <details>
-<summary>**📝 Cursor, VS Code, Windsurf and other MCP-compatible clients**</summary>
+<summary><b>📝 Cursor, VS Code, Windsurf and other MCP-compatible clients</b></summary>
 
 Add to your MCP configuration (Cursor: `.mcp/mcp.json` in your project root:
 
@@ -295,8 +295,8 @@ Search and extract documentation from any docset.
 | Parameter | Type | Description | Default |
 |-----------|------|-------------|---------|
 | `query` | string | API/function name to search | *required* |
-| `docset` | string | Target docset (e.g., 'nodejs', 'python_3') | 'apple_api_reference' |
-| `language` | string | Programming language filter | - |
+| `docset` | string | Target docset (e.g., 'nodejs', 'python_3') | *required* |
+| `language` | string | Programming language filter | docset default |
 | `max_results` | int | Number of results (1-10) | 3 |
 
 ### 📋 `search_cheatsheet`
@@ -324,13 +324,13 @@ List frameworks/types within a specific docset.
 
 | Parameter | Type | Description | Default |
 |-----------|------|-------------|---------|
-| `docset` | string | Target docset | 'apple_api_reference' |
+| `docset` | string | Target docset | *required* |
 | `filter` | string | Filter framework names | - |
 
 ## Troubleshooting
 
 <details>
-<summary>**❌ "Docset not found" error**</summary>
+<summary><b>❌ "Docset not found" error</b></summary>
 
 This means the docset isn't installed in Dash. To fix:
 
@@ -342,7 +342,7 @@ This means the docset isn't installed in Dash. To fix:
 </details>
 
 <details>
-<summary>**🔌 MCP connection failed**</summary>
+<summary><b>🔌 MCP connection failed</b></summary>
 
 1. **Check installation**: Run `pip show docsetmcp` to verify installation
 2. **Test manually**: Run `uvx docsetmcp` in terminal - you should see MCP output
@@ -354,7 +354,7 @@ This means the docset isn't installed in Dash. To fix:
 </details>
 
 <details>
-<summary>**📭 No results found**</summary>
+<summary><b>📭 No results found</b></summary>
 
 - The content might not be in your local Dash cache
 - Try searching with different terms or partial matches
@@ -364,7 +364,7 @@ This means the docset isn't installed in Dash. To fix:
 </details>
 
 <details>
-<summary>**🐛 Other issues**</summary>
+<summary><b>🐛 Other issues</b></summary>
 
 1. **Python version**: Ensure you have Python 3.10 or higher
 2. **UV not found**: Install UV package manager from <https://docs.astral.sh/uv/>

docsetmcp/__init__.py

@@ -1,5 +1,5 @@
 """DocsetMCP - Extract documentation from Dash docsets as Markdown through MCP"""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 __author__ = "Cody Bromley"
 __email__ = "dev@codybrom.com"

docsetmcp/server.py

@@ -1134,17 +1134,17 @@ def get_full_content(self) -> str:
 @mcp.tool()
 def search_docs(
     query: str,
-    docset: str = "apple_api_reference",
-    language: str = "swift",
+    docset: str,
+    language: str | None = None,
     max_results: int = 3,
 ) -> str:
     """
     Search and extract documentation from Dash docsets as Markdown.
 
     Args:
         query: The API/function name to search for (e.g., 'AppIntent', 'fs.readFile', 'echo')
-        docset: Docset to search in ('apple_api_reference', 'nodejs', 'bash', etc.)
-        language: Programming language variant (varies by docset)
+        docset: Docset to search in (e.g., 'apple_api_reference', 'nodejs', 'bash')
+        language: Programming language variant (optional, varies by docset)
         max_results: Maximum number of results to return (1-10)
 
     Returns:
@@ -1159,6 +1159,15 @@ def search_docs(
     if not 1 <= max_results <= 10:
         return "Error: max_results must be between 1 and 10"
 
+    # Use docset-specific default language if none provided
+    if language is None:
+        # Get the first configured language as default
+        config = extractor.config
+        if "languages" in config and config["languages"]:
+            language = next(iter(config["languages"]))
+        else:
+            language = "swift"  # Fallback for compatibility
+
     return extractor.search(query, language, max_results)
 
 
@@ -1187,14 +1196,12 @@ def list_available_docsets() -> str:
 
 
 @mcp.tool()
-def list_frameworks(
-    docset: str = "apple_api_reference", filter: str | None = None
-) -> str:
+def list_frameworks(docset: str, filter: str | None = None) -> str:
     """
     List available frameworks/types in a specific docset.
 
     Args:
-        docset: Docset to list from ('apple_api_reference', 'nodejs', 'bash', etc.)
+        docset: Docset to list from (e.g., 'nodejs', 'python_3', 'bash')
         filter: Optional filter for framework/type names
 
     Returns:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "docsetmcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Model Context Protocol server for Dash-style docsets",
   "scripts": {
     "setup": "./scripts/setup_env.sh",

setup.py

@@ -12,7 +12,7 @@
 
 setup(
     name="docsetmcp",
-    version="0.2.1",
+    version="0.2.2",
     author="Cody Bromley",
     author_email="dev@codybrom.com",
     description="Search local documentation from Dash through MCP",