MCP 服务器

VSC-MCP

这个项目提供的工具可以将语言服务器协议（LSP）的功能作为 MCP（模型上下文协议）工具公开。

thomasgazzoni

开发者工具

访问服务器

README

VSC-MCP

本项目提供将语言服务器协议 (LSP) 功能作为 MCP (模型上下文协议) 工具公开的工具。它使 AI 代理能够通过标准化的 MCP 工具调用，以编程方式分析和编辑 TypeScript/JavaScript 代码。

特性

在单文件模式或项目模式（tsconfig.json 检测）下工作。
通过 LSP API 进行语言无关的代码操作。
完全兼容模型上下文协议 (MCP) SDK。

安装

前提条件

Bun（用于包管理和构建）
Node.js（用于运行服务器）

设置

克隆存储库
安装依赖项：
```
bun install
```

在 Claude 中配置 (macOS)

要与 Claude Desktop 一起使用，请将服务器配置添加到 Claude Desktop 配置文件：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

将以下配置添加到配置文件的 mcp_servers 部分：

{
  "mcpServers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "repomix",
        "--mcp"
      ]
    },
    "vsc-mcp": {
      "command": "bun",
      "args": [
        "/path/to/your/vsc-mcp/src/index.ts"
      ],
      "env": {
        "LOG_DIR": "/path/to/your/vsc-mcp/logs",
        "ALLOWED_DIRECTORIES": "/path/to/your/vsc-mcp"
      }
    }
  }
}

我们需要 repomix mcp 服务器依赖项。

将 /path/to/your/vsc-mcp 替换为您克隆的 vsc-mcp 目录的实际路径。

安全特性

路径限制

VSC-MCP 工具包含一项安全功能，用于将文件操作限制在特定目录：

ALLOWED_DIRECTORIES：一个环境变量，用于指定允许文件操作的目录的逗号分隔列表。

示例：
```
ALLOWED_DIRECTORIES=/home/user/projects,/tmp/workspace
```
如果未设置此环境变量，则操作默认仅限于当前工作目录。
所有文件操作（读取、写入、编辑）都将检查目标路径是否在允许的目录内。
尝试访问允许目录之外的文件将导致“访问被拒绝”错误。

此功能有助于防止未经授权访问系统上的敏感文件和目录。

工作原理

在 --stdio 模式下启动 typescript-language-server。
发送 LSP 初始化和 didOpen 通知。
使用 workspace/symbol 和 textDocument/documentSymbol 请求查找符号。
回退到 textDocument/implementation 以进行额外的符号发现。
使用 applyWorkspaceEdit 实用程序将编辑直接应用于文件。
将操作结果返回给调用者。

可用工具

目前，可以使用以下工具：

editSymbol：使用 LSP 在给定文件中按名称和类型编辑符号（函数、类、方法等）。
- 支持各种符号类型：函数、方法、类、接口、变量、常量、属性、字段
- 使用 LSP 的 workspace/symbol 和 textDocument/documentSymbol 请求查找符号
- 将编辑直接应用于文件
readSymbol：使用 LSP 在给定文件中按名称和类型读取符号（函数、类、方法等）。
- 支持与 editSymbol 相同的符号类型
- 使用 LSP 定位符号并提取其内容
- 返回符号内容及其位置信息
readFile：读取文件的内容。
- 根据文件扩展名返回具有适当 MIME 类型的文件内容
- 处理各种文件格式，包括代码、文本和配置文件
- 提供有关常见问题的详细错误消息（文件未找到、目录访问等）
writeFile：创建新文件或使用提供的内容覆盖现有文件。
- 如果父目录不存在，则创建它们
- 支持任何文件类型
- 返回有关文件操作的信息（已创建/已覆盖、文件大小）
searchReplaceFile：搜索文件中的内容并将其替换为新内容。
- 搜索时忽略空格差异（空格、制表符、换行符）
- 支持灵活匹配内容模式
- 返回进行的替换次数