@treedy/lsp-mcp 0.1.7 → 0.1.9

package/dist/bundled/pyright/dist/tools/rename.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const renameSchema: {
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    newName: z.ZodString;
+};
+export declare function rename(args: {
+    file: string;
+    line: number;
+    column: number;
+    newName: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/bundled/pyright/dist/tools/search.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const searchSchema: {
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    caseSensitive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+};
+export declare function search(args: {
+    pattern: string;
+    path?: string;
+    glob?: string;
+    caseSensitive?: boolean;
+    maxResults?: number;
+}): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;

package/dist/bundled/pyright/dist/tools/signature-help.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare const signatureHelpSchema: {
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+};
+export declare function signatureHelp(args: {
+    file: string;
+    line: number;
+    column: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/bundled/pyright/dist/tools/status.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const statusSchema: {
+    file: z.ZodString;
+};
+type StatusArgs = {
+    file: string;
+};
+export declare function status(args: StatusArgs): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export {};

package/dist/bundled/pyright/dist/tools/symbols.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { SymbolFilter } from '../lsp/types.js';
+export declare const symbolsSchema: {
+    file: z.ZodString;
+    filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["all", "classes", "functions", "methods", "variables"]>>>;
+    includeChildren: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
+export declare function symbols(args: {
+    file: string;
+    filter?: SymbolFilter;
+    includeChildren?: boolean;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/bundled/pyright/dist/tools/update-document.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const updateDocumentSchema: {
+    file: z.ZodString;
+    content: z.ZodString;
+};
+export declare function updateDocument(args: {
+    file: string;
+    content: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/bundled/pyright/dist/utils/position.d.ts

@@ -0,0 +1,33 @@
+import { Position, Range, Location } from 'vscode-languageserver-protocol';
+/**
+ * Convert 1-based line/column (user input) to 0-based LSP Position
+ */
+export declare function toPosition(line: number, column: number): Position;
+/**
+ * Convert 0-based LSP Position to 1-based line/column (user output)
+ */
+export declare function fromPosition(pos: Position): {
+    line: number;
+    column: number;
+};
+/**
+ * Format a Location for display
+ */
+export declare function formatLocation(loc: Location): string;
+/**
+ * Format a Range for display
+ */
+export declare function formatRange(range: Range): string;
+/**
+ * Convert file path to URI
+ */
+export declare function pathToUri(filePath: string): string;
+/**
+ * Convert URI to file path
+ */
+export declare function uriToPath(uri: string): string;
+/**
+ * Find project root by looking for pyrightconfig.json or pyproject.toml
+ * starting from the given file path and walking up the directory tree
+ */
+export declare function findProjectRoot(filePath: string): string;

package/dist/bundled/pyright/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@treedy/pyright-mcp",
+  "version": "1.1.6",
+  "description": "MCP server exposing Pyright LSP features for Python code intelligence",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "pyright-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "build:tsc": "tsc",
+    "prepublishOnly": "bun run build",
+    "start": "bun dist/index.js",
+    "dev": "bun --watch src/index.ts",
+    "test:pyright": "bun test/test-pyright-direct.mjs",
+    "test:mcp": "bun test/test-mcp.mjs",
+    "test:benchmark": "node test/test-benchmark.mjs",
+    "inspector": "bunx @modelcontextprotocol/inspector bun dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "pyright",
+    "python",
+    "lsp",
+    "language-server",
+    "claude",
+    "ai",
+    "code-intelligence",
+    "type-checking"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "vscode-jsonrpc": "^8.2.0",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}

package/dist/bundled/python/README.md

@@ -0,0 +1,230 @@
+# Python LSP MCP Server
+
+Python MCP server providing code analysis features using [Rope](https://github.com/python-rope/rope) and [Pyright](https://github.com/microsoft/pyright).
+
+## Features
+
+| Tool | Description | Backend |
+|------|-------------|---------|
+| `hover` | Get documentation at position | Rope/Pyright |
+| `definition` | Go to symbol definition | Rope/Pyright |
+| `references` | Find all references | Rope/Pyright |
+| `completions` | Code completion suggestions | Rope/Pyright |
+| `symbols` | Extract document symbols | Rope/Pyright |
+| `rename` | Rename refactoring | Rope |
+| `move` | Move function/class to another module | Rope |
+| `change_signature` | Change function parameters | Rope |
+| `function_signature` | Get function signature info | Rope |
+| `diagnostics` | Type checking errors | Pyright |
+| `signature_help` | Function signatures | Pyright |
+| `update_document` | Incremental document updates | Pyright |
+| `search` | Regex search in files | ripgrep |
+| `set_backend` | Switch backend at runtime | - |
+| `status` | Server status info | - |
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+# Using uvx (no install needed)
+uvx python-lsp-mcp@latest
+
+# Using pipx
+pipx install python-lsp-mcp
+
+# Using pip
+pip install python-lsp-mcp
+```
+
+### From Source
+
+```bash
+cd python
+uv sync
+uv run python-lsp-mcp
+```
+
+## Usage
+
+### Run the server
+
+```bash
+# With uvx (recommended)
+uvx python-lsp-mcp@latest
+
+# With pip install
+python-lsp-mcp
+
+# From source
+uv run python-lsp-mcp
+```
+
+### Configure in Claude Code
+
+Add to your `.mcp.json` or MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "python-lsp-mcp": {
+      "command": "uvx",
+      "args": ["python-lsp-mcp@latest"]
+    }
+  }
+}
+```
+
+Or if installed from source:
+
+```json
+{
+  "mcpServers": {
+    "python-lsp-mcp": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/PyLspMcp/python", "python-lsp-mcp"]
+    }
+  }
+}
+```
+
+### MCP Inspector
+
+```bash
+uvx mcp dev python-lsp-mcp
+```
+
+## Configuration
+
+### Backend Selection
+
+The server supports two backends for shared tools (hover, definition, references, completions, symbols):
+
+| Backend | Strengths | Use Case |
+|---------|-----------|----------|
+| **rope** (default) | Fast, low latency, good refactoring | Quick operations, CI/CD |
+| **pyright** | Accurate types, cross-file analysis | Type-heavy projects |
+
+### Runtime Switching
+
+Use the `set_backend` tool to switch backends at runtime:
+
+```python
+# Switch all shared tools to pyright
+set_backend(backend="pyright")
+
+# Switch only hover to rope
+set_backend(backend="rope", tool="hover")
+
+# Check current configuration
+status()
+```
+
+### Environment Variables
+
+Configure backends at startup via environment variables (supports both prefixes):
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PYTHON_LSP_MCP_BACKEND` | Default backend (`rope` or `pyright`) | `rope` |
+| `PYTHON_LSP_MCP_HOVER_BACKEND` | Backend for hover | inherited |
+| `PYTHON_LSP_MCP_DEFINITION_BACKEND` | Backend for definition | inherited |
+| `PYTHON_LSP_MCP_REFERENCES_BACKEND` | Backend for references | inherited |
+| `PYTHON_LSP_MCP_COMPLETIONS_BACKEND` | Backend for completions | inherited |
+| `PYTHON_LSP_MCP_SYMBOLS_BACKEND` | Backend for symbols | inherited |
+| `PYTHON_LSP_MCP_NO_CACHE` | Disable Rope caching (`1` or `true`) | `false` |
+
+> Note: `ROPE_MCP_*` prefix is also supported for backward compatibility.
+
+### Rope Caching
+
+By default, Rope creates a `.ropeproject` folder in each analyzed project to cache analysis results. This significantly improves performance for medium to large projects.
+
+- **Cache location**: `.ropeproject/` in each project root (project-isolated)
+- **Cache contents**: Module info, object database, refactoring history
+- **Disable caching**: Set `PYTHON_LSP_MCP_NO_CACHE=1`
+
+You may want to add `.ropeproject/` to your `.gitignore`.
+
+Example:
+```bash
+# Use pyright for all shared tools
+PYTHON_LSP_MCP_BACKEND=pyright uvx python-lsp-mcp@latest
+
+# Use pyright for hover only
+PYTHON_LSP_MCP_HOVER_BACKEND=pyright uvx python-lsp-mcp@latest
+```
+
+## Development
+
+### Run tests
+
+```bash
+uv run pytest tests/ -v
+```
+
+### Run benchmarks
+
+```bash
+uv run pytest tests/test_benchmark.py -v -s
+```
+
+## Architecture
+
+```
+┌─────────────────┐     stdio      ┌─────────────────────┐
+│  Claude / AI    │ ◄────────────► │     python-lsp-mcp        │
+│                 │      MCP       │                     │
+└─────────────────┘                └─────────┬───────────┘
+                                             │
+                           ┌─────────────────┼─────────────────┐
+                           │                 │                 │
+                           ▼                 ▼                 ▼
+                    ┌───────────┐     ┌───────────┐     ┌───────────┐
+                    │   Rope    │     │  Pyright  │     │ Pyright   │
+                    │  Library  │     │   CLI     │     │   LSP     │
+                    └───────────┘     └───────────┘     └───────────┘
+```
+
+## Project Structure
+
+```
+python/
+├── pyproject.toml
+├── src/rope_mcp/
+│   ├── server.py           # MCP server entry point
+│   ├── rope_client.py      # Rope library wrapper
+│   ├── pyright_client.py   # Pyright CLI wrapper
+│   ├── config.py           # Backend configuration
+│   ├── lsp/                # LSP client for Pyright
+│   │   ├── client.py
+│   │   └── types.py
+│   └── tools/              # Tool implementations
+│       ├── hover.py
+│       ├── definition.py
+│       ├── references.py
+│       ├── completions.py
+│       ├── symbols.py
+│       ├── rename.py
+│       └── diagnostics.py
+└── tests/
+    ├── test_tools.py
+    └── test_benchmark.py
+```
+
+## Performance
+
+Rope is significantly faster than Pyright LSP for basic operations:
+
+| Tool | Rope (ms) | Pyright (ms) | Speedup |
+|------|-----------|--------------|---------|
+| hover | 0.16 | 0.79 | 4.9x |
+| definition | 0.12 | 0.40 | 3.3x |
+| completions | 0.36 | 1.52 | 4.2x |
+| symbols | 0.24 | 0.44 | 1.8x |
+
+See [docs/BENCHMARKS.md](../docs/BENCHMARKS.md) for detailed benchmarks.
+
+## License
+
+MIT

package/dist/bundled/python/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "python-lsp-mcp"
+version = "0.3.1"
+description = "MCP server providing Python code analysis using Rope and Pyright"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "treedy" }]
+keywords = [
+  "mcp",
+  "rope",
+  "pyright",
+  "python",
+  "lsp",
+  "code-intelligence",
+  "claude",
+  "ai",
+  "refactoring",
+  "type-checking",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Text Editors :: Integrated Development Environments (IDE)",
+]
+dependencies = [
+  "mcp>=1.0.0",
+  "rope>=1.13.0",
+  "tomli>=2.0.0; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+dev = ["watchdog>=4.0.0", "pytest>=8.0.0", "ruff>=0.4.0"]
+
+[project.urls]
+Homepage = "https://github.com/pinylin/pyright-mcp"
+Repository = "https://github.com/pinylin/pyright-mcp"
+Documentation = "https://github.com/pinylin/pyright-mcp#readme"
+
+[project.scripts]
+python-lsp-mcp = "rope_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rope_mcp"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = ["pytest>=9.0.2"]

package/dist/bundled/python/src/rope_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Rope MCP Server - Python code analysis via MCP."""
+
+__version__ = "0.1.0"