mcp-tap 0.3.0 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felipe Stenzel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# mcp-tap
+
+**The last MCP server you install by hand.**
+
+mcp-tap lives inside your AI assistant. Ask it to find, install, and configure
+any MCP server — by talking to it. No more editing JSON files. No more
+Googling environment variables.
+
+> This is a thin Node.js wrapper that delegates to the Python package
+> ([PyPI: mcp-tap](https://pypi.org/project/mcp-tap/)). It lets you use
+> `npx mcp-tap` if you prefer npm-style tooling.
+
+## Install
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-tap": {
+      "command": "npx",
+      "args": ["-y", "mcp-tap"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add mcp-tap -- npx -y mcp-tap
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-tap": {
+      "command": "npx",
+      "args": ["-y", "mcp-tap"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-tap": {
+      "command": "npx",
+      "args": ["-y", "mcp-tap"]
+    }
+  }
+}
+```
+
+## How it works
+
+This wrapper resolves the Python runtime in order:
+
+1. **uvx** (preferred) — uv's tool runner, fast and isolated
+2. **pipx run** — common Python tool runner
+3. **python -m mcp_tap** — requires prior `pip install mcp-tap`
+
+## What can mcp-tap do?
+
+| You say | mcp-tap does |
+|---------|-------------|
+| "Scan my project" | Detects your tech stack, recommends MCP servers |
+| "Find me an MCP for PostgreSQL" | Searches the registry, compares options |
+| "Set it up" | Installs, configures, validates the connection |
+| "Are my servers working?" | Health-checks every server concurrently |
+| "Lock my MCP setup" | Creates `mcp-tap.lock` for reproducible configs |
+
+## 12 Tools
+
+`scan_project` · `search_servers` · `configure_server` · `test_connection` ·
+`check_health` · `inspect_server` · `list_installed` · `remove_server` ·
+`verify` · `restore` · `apply_stack`
+
+Plus automatic lockfile management on configure/remove.
+
+## Requirements
+
+- Python 3.11+ (via [uv](https://docs.astral.sh/uv/), pipx, or system Python)
+
+## Links
+
+- **GitHub**: https://github.com/felipestenzel/mcp-tap
+- **PyPI**: https://pypi.org/project/mcp-tap/
+- **License**: MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-tap",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "The last MCP server you install by hand. Discover, install, and configure MCP servers from inside your AI assistant.",
   "keywords": [
     "mcp",
@@ -21,7 +21,7 @@
     "url": "https://github.com/felipestenzel/mcp-tap/issues"
   },
   "bin": {
-    "mcp-tap": "./bin/mcp-tap.js"
+    "mcp-tap": "bin/mcp-tap.js"
   },
   "files": [
     "bin/",