cicada-mcp 0.1.4__tar.gz → 0.1.5__tar.gz

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cicada-mcp
-Version: 0.1.4
+Version: 0.1.5
 Summary: An Elixir module search MCP server
 Author-email: wende <wende@hey.com>
 Maintainer-email: wende <wende@hey.com>
@@ -138,7 +138,7 @@ cicada claude  # or: cicada cursor, cicada vs
 
 **Available commands after installation:**
 - `cicada [claude|cursor|vs]` - One-command setup per project
-- `cicada-server` - MCP server (auto-started by editor)
+- `cicada-mcp` - MCP server (auto-started by editor)
 - `cicada-index` - Re-index code with custom options (medium/large spaCy models)
 - `cicada-index-pr` - Index pull requests for PR attribution
 - `cicada-install` - Legacy setup (creates `.cicada/` in repo)
@@ -169,6 +169,33 @@ uvx --from git+https://github.com/wende/cicada.git@latest cicada vs
 
 Once you're convinced, install permanently with `uv tool install` above!
 
+### Quick Setup for Cursor and Claude Code
+
+**For Cursor:**
+
+Click the install button at the top of this README or visit:
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=cicada&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBnaXQraHR0cHM6Ly9naXRodWIuY29tL3dlbmRlL2NpY2FkYS5naXRAbGF0ZXN0IGNpY2FkYS1zZXJ2ZXIgLiJ9)
+
+**For Claude Code:**
+
+```bash
+# Option 1: Using claude mcp add command
+claude mcp add cicada -- uvx --from git+https://github.com/wende/cicada.git@latest cicada-mcp ./path/to/your/codebase
+
+# Option 2: Using setup script
+uvx --from git+https://github.com/wende/cicada.git@latest cicada claude
+```
+
+**Then for both editors,** run these commands in your codebase to generate keyword lookup and GitHub PR lookup databases:
+
+```bash
+# Generate keyword lookup database
+uvx --from git+https://github.com/wende/cicada.git@latest cicada-index .
+
+# Generate GitHub PR lookup database
+uvx --from git+https://github.com/wende/cicada.git@latest cicada-index-pr .
+```
+
 ---
 
 ## Quick Start
@@ -221,7 +248,7 @@ your-project/
 {
   "mcpServers": {
     "cicada": {
-      "command": "cicada-server",
+      "command": "cicada-mcp",
       "env": {
         "CICADA_REPO_PATH": "/path/to/project",
         "CICADA_CONFIG_DIR": "/home/user/.cicada/projects/<hash>"

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/README.md

@@ -94,7 +94,7 @@ cicada claude  # or: cicada cursor, cicada vs
 
 **Available commands after installation:**
 - `cicada [claude|cursor|vs]` - One-command setup per project
-- `cicada-server` - MCP server (auto-started by editor)
+- `cicada-mcp` - MCP server (auto-started by editor)
 - `cicada-index` - Re-index code with custom options (medium/large spaCy models)
 - `cicada-index-pr` - Index pull requests for PR attribution
 - `cicada-install` - Legacy setup (creates `.cicada/` in repo)
@@ -125,6 +125,33 @@ uvx --from git+https://github.com/wende/cicada.git@latest cicada vs
 
 Once you're convinced, install permanently with `uv tool install` above!
 
+### Quick Setup for Cursor and Claude Code
+
+**For Cursor:**
+
+Click the install button at the top of this README or visit:
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=cicada&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBnaXQraHR0cHM6Ly9naXRodWIuY29tL3dlbmRlL2NpY2FkYS5naXRAbGF0ZXN0IGNpY2FkYS1zZXJ2ZXIgLiJ9)
+
+**For Claude Code:**
+
+```bash
+# Option 1: Using claude mcp add command
+claude mcp add cicada -- uvx --from git+https://github.com/wende/cicada.git@latest cicada-mcp ./path/to/your/codebase
+
+# Option 2: Using setup script
+uvx --from git+https://github.com/wende/cicada.git@latest cicada claude
+```
+
+**Then for both editors,** run these commands in your codebase to generate keyword lookup and GitHub PR lookup databases:
+
+```bash
+# Generate keyword lookup database
+uvx --from git+https://github.com/wende/cicada.git@latest cicada-index .
+
+# Generate GitHub PR lookup database
+uvx --from git+https://github.com/wende/cicada.git@latest cicada-index-pr .
+```
+
 ---
 
 ## Quick Start
@@ -177,7 +204,7 @@ your-project/
 {
   "mcpServers": {
     "cicada": {
-      "command": "cicada-server",
+      "command": "cicada-mcp",
       "env": {
         "CICADA_REPO_PATH": "/path/to/project",
         "CICADA_CONFIG_DIR": "/home/user/.cicada/projects/<hash>"

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/cicada/install.py

@@ -251,7 +251,15 @@ def detect_installation_method():
         ".local/share/uv/tools" in script_path_str
         or ".local/bin/cicada-" in script_path_str
     ):
-        # Installed via uv tool install
+        # Installed via uv tool install - check for cicada-mcp first
+        if shutil.which("cicada-mcp"):
+            return (
+                "cicada-mcp",
+                [],
+                None,
+                "uv tool install (ensure ~/.local/bin is in PATH)",
+            )
+        # Fall back to cicada-server for backwards compatibility
         return (
             "cicada-server",
             [],
@@ -259,7 +267,11 @@ def detect_installation_method():
             "uv tool install (ensure ~/.local/bin is in PATH)",
         )
 
-    # Check if cicada-server is in PATH (from uv tool install)
+    # Check if cicada-mcp is in PATH first (from uv tool install)
+    if shutil.which("cicada-mcp"):
+        return ("cicada-mcp", [], None, "uv tool install (permanent, fast)")
+
+    # Fall back to cicada-server for backwards compatibility
     if shutil.which("cicada-server"):
         return ("cicada-server", [], None, "uv tool install (permanent, fast)")
 
@@ -279,8 +291,13 @@ def check_tools_in_path():
     """Check if cicada tools are in PATH."""
     import shutil
 
-    tools = ["cicada-server", "cicada-index"]
+    # Check for cicada-mcp (new) or cicada-server (backwards compat)
+    has_mcp_server = shutil.which("cicada-mcp") or shutil.which("cicada-server")
+    tools = ["cicada-index"]
     visible_tools = [tool for tool in tools if shutil.which(tool)]
+    if has_mcp_server:
+        visible_tools.insert(0, "cicada-mcp/cicada-server")
+        tools.insert(0, "cicada-mcp/cicada-server")
 
     if len(visible_tools) == len(tools):
         return "all_visible"
@@ -351,8 +368,8 @@ def create_mcp_config(repo_path, _cicada_dir, _python_bin):
     print(f"✓ MCP configuration updated at {mcp_config_path}")
 
     # Show what was configured
-    if command == "cicada-server":
-        print("✅ Using 'cicada-server' command (fast, no paths needed)")
+    if command in ("cicada-mcp", "cicada-server"):
+        print(f"✅ Using '{command}' command (fast, no paths needed)")
     else:
         print(f"ℹ️  Using Python: {command}")
 

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/cicada/setup.py

@@ -102,9 +102,15 @@ def get_mcp_config_for_editor(
     # Detect installation method
     import shutil
 
+    # Check for cicada-mcp first (new name), fall back to cicada-server (backwards compat)
+    has_cicada_mcp = shutil.which("cicada-mcp") is not None
     has_cicada_server = shutil.which("cicada-server") is not None
 
-    if has_cicada_server:
+    if has_cicada_mcp:
+        command = "cicada-mcp"
+        args = []
+        cwd = None
+    elif has_cicada_server:
         command = "cicada-server"
         args = []
         cwd = None
@@ -275,7 +281,8 @@ def setup(editor: EditorType, repo_path: Path | None = None) -> None:
     import shutil
     from cicada import __version__
 
-    if not shutil.which("cicada-server"):
+    # Check for either cicada-mcp or cicada-server (backwards compat)
+    if not (shutil.which("cicada-mcp") or shutil.which("cicada-server")):
         print("💡 Tip: For best experience, install Cicada permanently:")
         print(
             f"   uv tool install git+https://github.com/wende/cicada.git@v{__version__}"

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/cicada_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cicada-mcp
-Version: 0.1.4
+Version: 0.1.5
 Summary: An Elixir module search MCP server
 Author-email: wende <wende@hey.com>
 Maintainer-email: wende <wende@hey.com>
@@ -138,7 +138,7 @@ cicada claude  # or: cicada cursor, cicada vs
 
 **Available commands after installation:**
 - `cicada [claude|cursor|vs]` - One-command setup per project
-- `cicada-server` - MCP server (auto-started by editor)
+- `cicada-mcp` - MCP server (auto-started by editor)
 - `cicada-index` - Re-index code with custom options (medium/large spaCy models)
 - `cicada-index-pr` - Index pull requests for PR attribution
 - `cicada-install` - Legacy setup (creates `.cicada/` in repo)
@@ -169,6 +169,33 @@ uvx --from git+https://github.com/wende/cicada.git@latest cicada vs
 
 Once you're convinced, install permanently with `uv tool install` above!
 
+### Quick Setup for Cursor and Claude Code
+
+**For Cursor:**
+
+Click the install button at the top of this README or visit:
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=cicada&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBnaXQraHR0cHM6Ly9naXRodWIuY29tL3dlbmRlL2NpY2FkYS5naXRAbGF0ZXN0IGNpY2FkYS1zZXJ2ZXIgLiJ9)
+
+**For Claude Code:**
+
+```bash
+# Option 1: Using claude mcp add command
+claude mcp add cicada -- uvx --from git+https://github.com/wende/cicada.git@latest cicada-mcp ./path/to/your/codebase
+
+# Option 2: Using setup script
+uvx --from git+https://github.com/wende/cicada.git@latest cicada claude
+```
+
+**Then for both editors,** run these commands in your codebase to generate keyword lookup and GitHub PR lookup databases:
+
+```bash
+# Generate keyword lookup database
+uvx --from git+https://github.com/wende/cicada.git@latest cicada-index .
+
+# Generate GitHub PR lookup database
+uvx --from git+https://github.com/wende/cicada.git@latest cicada-index-pr .
+```
+
 ---
 
 ## Quick Start
@@ -221,7 +248,7 @@ your-project/
 {
   "mcpServers": {
     "cicada": {
-      "command": "cicada-server",
+      "command": "cicada-mcp",
       "env": {
         "CICADA_REPO_PATH": "/path/to/project",
         "CICADA_CONFIG_DIR": "/home/user/.cicada/projects/<hash>"

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/cicada_mcp.egg-info/SOURCES.txt

@@ -10,7 +10,6 @@ cicada/formatter.py
 cicada/git_helper.py
 cicada/indexer.py
 cicada/install.py
-cicada/keyword_extractor.py
 cicada/keyword_search.py
 cicada/lightweight_keyword_extractor.py
 cicada/mcp_server.py
@@ -71,6 +70,7 @@ tests/test_install_summary.py
 tests/test_intelligent_mcp_config.py
 tests/test_keyword_search.py
 tests/test_line_mapper.py
+tests/test_mcp_e2e.py
 tests/test_mcp_git_integration.py
 tests/test_mcp_logging_integration.py
 tests/test_mcp_pr_tools.py

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/cicada_mcp.egg-info/entry_points.txt

@@ -5,4 +5,5 @@ cicada-find-dead-code = cicada.find_dead_code:main
 cicada-index = cicada.indexer:main
 cicada-index-pr = cicada.pr_indexer:main
 cicada-install = cicada.install:main
+cicada-mcp = cicada.mcp_server:main
 cicada-server = cicada.mcp_server:main

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cicada-mcp"
-version = "0.1.4"
+version = "0.1.5"
 description = "An Elixir module search MCP server"
 readme = "README.md"
 license = "MIT"
@@ -59,7 +59,8 @@ Changelog = "https://github.com/wende/cicada/blob/main/CHANGELOG.md"
 Documentation = "https://github.com/wende/cicada#readme"
 
 [project.scripts]
-cicada-server = "cicada.mcp_server:main"
+cicada-mcp = "cicada.mcp_server:main"
+cicada-server = "cicada.mcp_server:main"  # Backwards compatibility
 cicada = "cicada.setup:main"
 cicada-install = "cicada.install:main"
 cicada-clean = "cicada.clean:main"
@@ -84,6 +85,7 @@ asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 filterwarnings = [
     "ignore:Importing 'parser.split_arg_string' is deprecated.*:DeprecationWarning",
+    "ignore:coroutine 'async_main' was never awaited:RuntimeWarning",
 ]
 
 [tool.coverage.run]

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/tests/test_install_comprehensive.py

@@ -387,20 +387,34 @@ class TestDetectInstallationMethod:
 
     def test_detect_uv_tools_permanent(self):
         """Test detection of uv tool install."""
-        with patch(
-            "sys.argv", ["/Users/user/.local/share/uv/tools/cicada/bin/cicada-setup"]
+        with (
+            patch(
+                "sys.argv",
+                ["/Users/user/.local/share/uv/tools/cicada/bin/cicada-setup"],
+            ),
+            patch(
+                "shutil.which",
+                side_effect=lambda tool: (
+                    "/usr/local/bin/" + tool if tool == "cicada-mcp" else None
+                ),
+            ),
         ):
             command, args, cwd, _description = detect_installation_method()
 
-            assert command == "cicada-server"
+            assert command == "cicada-mcp"
             assert args == []
             assert cwd is None
 
     def test_detect_cicada_server_in_path(self):
-        """Test when cicada-server is in PATH."""
+        """Test when only cicada-server is in PATH (backwards compatibility)."""
         with (
             patch("sys.argv", ["/some/path/script.py"]),
-            patch("shutil.which", return_value="/usr/local/bin/cicada-server"),
+            patch(
+                "shutil.which",
+                side_effect=lambda tool: (
+                    "/usr/local/bin/cicada-server" if tool == "cicada-server" else None
+                ),
+            ),
         ):
 
             command, args, cwd, description = detect_installation_method()

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/tests/test_install_detection.py

@@ -48,13 +48,39 @@ def test_uv_tool_install_detection():
     ]
 
     for uv_path in uv_paths:
-        with patch("sys.argv", [uv_path]):
+        # Test with cicada-mcp available (new default)
+        with (
+            patch("sys.argv", [uv_path]),
+            patch(
+                "shutil.which",
+                side_effect=lambda tool: (
+                    "/usr/local/bin/cicada-mcp" if tool == "cicada-mcp" else None
+                ),
+            ),
+        ):
             command, args, cwd, description = detect_installation_method()
 
-            # Should use cicada-server for permanent installs
+            # Should use cicada-mcp for new installs
             assert (
-                command == "cicada-server"
+                command == "cicada-mcp"
             ), f"uv tool install path {uv_path} not detected correctly"
+            assert args == [], "Should have no args for cicada-mcp"
+            assert cwd is None, "Should have no cwd for cicada-mcp"
+
+        # Test backwards compatibility with only cicada-server available
+        with (
+            patch("sys.argv", [uv_path]),
+            patch(
+                "shutil.which",
+                side_effect=lambda tool: (
+                    "/usr/local/bin/cicada-server" if tool == "cicada-server" else None
+                ),
+            ),
+        ):
+            command, args, cwd, description = detect_installation_method()
+
+            # Should fall back to cicada-server for backwards compat
+            assert command == "cicada-server", f"Backwards compat failed for {uv_path}"
             assert args == [], "Should have no args for cicada-server"
             assert cwd is None, "Should have no cwd for cicada-server"
 

{cicada_mcp-0.1.4 → cicada_mcp-0.1.5}/tests/test_keyword_search.py

@@ -137,7 +137,11 @@ class TestKeywordExtractor:
     def test_invalid_model_size(self):
         """Test that model_size parameter is ignored (for API compatibility)"""
         # Lightweight extractor accepts any model_size for compatibility but ignores it
-        extractor = KeywordExtractor(verbose=False, model_size="invalid")
+        import warnings
+
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore", DeprecationWarning)
+            extractor = KeywordExtractor(verbose=False, model_size="invalid")
         assert extractor.model_size == "invalid"  # Stored but not validated
 
     def test_split_camel_case(self):
@@ -378,7 +382,11 @@ class TestKeywordExtractor:
 
     def test_medium_model_on_elixir_doc(self):
         """Test medium spaCy model on Elixir documentation"""
-        extractor = KeywordExtractor(verbose=True, model_size="medium")
+        import warnings
+
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore", DeprecationWarning)
+            extractor = KeywordExtractor(verbose=True, model_size="medium")
 
         # Small Elixir documentation text
         text = """