Code Copy MCP

代码复制MCP服务器

一种模型上下文协议（MCP）服务器，允许在具有安全控制和验证的文件之间进行代码复制粘贴操作。

目录

• 特性
• 工具
• 安装和配置

- 先决条件 - 快速设置

• MCP客户端集成

- 1.克劳德桌面 - 2.光标（AI代码编辑器） - 3.克劳德密码

• 配置

- 环境变量 - 安全配置 - 故障排除

• 用法示例

- 示例1：将函数从一个文件复制到另一个文件 - 示例2：用备份替换代码 - 示例3：复制整个文件

• 安全特性
• 项目结构
• 依赖项
• 日志记录

特性

• 逐行代码复制：从源文件中提取特定的行范围
• 精确粘贴：在目标文件中的精确行位置插入代码
• 整个文件操作：复制完整的文件内容
• 查找并替换：使用备份支持查找和替换文本模式
• 文件信息：获取有关文件的元数据和统计信息
• 安全控制：将操作限制在允许的目录中
• 备份创建：文件修改前的自动备份

工具

复制码

从源文件中复制带有可选行号的代码行。

copy_code(
    source_file: str,
    start_line: int,
    end_line: Optional[int] = None,
    include_line_numbers: bool = False
) -> str

粘贴代码

将代码粘贴到目标文件中的特定行号。

paste_code(
    target_file: str,
    line_number: int,
    code: str,
    create_backup: bool = True
) -> str

copy_entire_file

复制源文件的完整内容。

copy_entire_file(
    source_file: str,
    include_line_numbers: bool = False
) -> str

搜索和替换

搜索和替换文件中的文本模式。

search_and_replace(
    target_file: str,
    search_pattern: str,
    replacement: str,
    case_sensitive: bool = True,
    replace_all: bool = True,
    create_backup: bool = True
) -> str

获取_文件_信息

获取文件的详细信息。

get_file_info(file_path: str) -> str

安装

先决条件

• Python 3.11或更高版本
• UV包管理器

设置

1. 克隆或创建项目：

cd /Users/map/Documents/Repos/code-copy-mcp

1. 安装依赖项：

uv install

1. 配置允许的目录（可选）：

cp .env.example .env
# Edit .env to set your ALLOWED_DIRECTORIES

用法

运行服务器

uv run python mcp_server.py

发展模式

# Activate virtual environment first
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Run server
python mcp_server.py

配置

创建一个 .env 项目根目录中的文件：

# Comma-separated list of allowed directories
ALLOWED_DIRECTORIES=/Users/yourname,/Users/yourname/Documents,/Users/yourname/Projects

如果未指定，则默认为：

• 用户的主目录
• 文档文件夹
• 桌面文件夹
• 项目文件夹（如果存在）

安全特性

• 路径验证可防止目录遍历攻击
• 文件权限检查确保读/写访问
• 修改前自动创建备份
• 仅限于配置的目录进行操作

工作流示例

1. 从源文件复制代码行：

   copy_code("/path/to/source.py", start_line=10, end_line=20)

1. 将代码粘贴到目标文件中：

   paste_code("/path/to/target.py", line_number=5, code=" copied_code_content ")

1. 获取文件信息：

   get_file_info("/path/to/target.py")

安装和配置

先决条件

• Python 3.11或更高版本
• UV包管理器（推荐）或pip
• 支持的MCP客户端之一

快速设置

1. 克隆存储库：

   git clone https://github.com/mhattingpete/code-copy-mcp.git
   cd code-copy-mcp

1. 安装依赖项：

   uv sync
   # Or without UV: pip install -e .

1. 配置允许的目录（可选）：

   cp .env.example .env
   # Edit .env to set your ALLOWED_DIRECTORIES

MCP客户端集成

1.克劳德桌面

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "code-copy": {
      "command": "/full/path/to/uv",
      "args": ["--directory", "/full/path/to/code-copy-mcp", "run", "python", "mcp_server.py"],
      "env": {
        "ALLOWED_DIRECTORIES": "/Users/yourname,/Users/yourname/Documents,/Users/yourname/Projects"
      }
    }
  }
}

2.光标（AI代码编辑器）

1. 打开光标设置(Cmd/Ctrl + ,)
2. 导航至 Extensions → MCP Servers
3. 添加新服务器：

   Name: Code Copy MCP
   Command: full/path/to/uv
   Arguments: --directory /full/path/to/code-copy-mcp run python mcp_server.py
   Environment Variables:
     ALLOWED_DIRECTORIES=/Users/yourname,/Users/yourname/Documents,/Users/yourname/Projects

3.克劳德密码

1. 安装Claude代码
2. 添加服务器配置：

   claude mcp add-json code-copy '{"type":"stdio","command":"full/path/to/uv","args":["--directory", "/full/path/to/code-copy-mcp", "run", "python", "mcp_server.py"],"env": {"ALLOWED_DIRECTORIES": "/Users/yourname,/Users/yourname/Documents,/Users/yourname/Projects"}}'

配置

环境变量

创建一个 .env 项目根目录中的文件：

# Comma-separated list of directories where file operations are allowed
# Examples for different operating systems:

# macOS/Linux:
ALLOWED_DIRECTORIES=/Users/yourname,/Users/yourname/Documents,/Users/yourname/Projects

# Windows:
ALLOWED_DIRECTORIES=C:\Users\YourName,C:\Users\YourName\Documents,C:\Users\YourName\Projects

# If not specified, defaults to:
# - User's home directory
# - Documents folder  
# - Desktop folder
# - Projects folder (if exists)

安全配置

出于安全原因，服务器只允许在指定目录内进行操作。 确保包含要执行代码复制粘贴操作的所有目录。

故障排除

常见问题：

1. “找不到模块”错误：

   # Ensure dependencies are installed
   uv install
   # Or with pip:
   pip install -e .

1. 权限被拒绝错误：

- 检查允许的目录是否配置正确 - 确保目录存在并且可访问

1. MCP服务器未出现：

- 验证命令路径是否正确 - 检查客户端日志中的错误消息 - 配置更改后重新启动MCP客户端

用法示例

配置后，您可以使用MCP客户端中的工具：

示例1：将函数从一个文件复制到另一个文件

User: Copy the function calculate_total from utils.py and paste it into main.py at line 50

助理将：

1. 使用 get_file_info 检查文件
2. 使用 copy_code 使用适当的行号
3. 使用 paste_code 在指定位置

示例2：用备份替换代码

User: Replace all occurrences of "old_method" with "new_method" in all Python files and create backups

助理将：

1. 使用 search_and_replace 在每个文件上
2. 验证更改 get_file_info
3. 报告所做的修改

示例3：复制整个文件

User: Make a copy of template.py as new_template.py

助理将：

1. 使用 copy_entire_file 获取内容
2. 使用 paste_code 创建新文件

项目结构

code-copy-mcp/
├── mcp_server.py          # Main MCP server
├── tools/
│   ├── __init__.py        # Package init
│   ├── validation.py      # Security validation
│   └── copy_tools.py      # Copy-paste tools
├── .env.example           # Configuration template
├── pyproject.toml         # UV project configuration
└── README.md              # This file

依赖项

• fastmcp:MCP服务器框架
• pydantic：数据验证
• loguru：结构化日志
• python dotenv：环境文件支持

日志记录

日志被写入 ~/.code-copy-mcp/mcp_server.log 与：

• 旋转1MB
• 7天保留期
• 用于故障排除的调试级日志记录