Cc Edit Jp MCP

克劳德 编辑 MCP

使用FastMCP的日语对应文件编辑MCP服务器。

针对以Tab缩进为基础的代码库中，ClaudeCode标准编辑工具出现错误（Error editing file）的情况，此MCP为应对措施。

特征

• 支持UTF-8正确处理包含日语的文本文件
• 隐式缩进转换自动将制表符和空格（4个空格）进行转换

- 在加载时将制表符转换为4个空格 - 编辑时将4个空格转换为制表符后保存

• HTTP接口可通过HTTP访问
• 支持MCP协议可与Claude整合
• 多种编辑功能:

- 文件加载（read_file- 将制表符转换为4个空格 - 字符串替换（edit_file) - 自动缩进转换 - 文件写入（write_file- 将空格转换为制表符 - 行置换replace_line)

安装

前提条件

• Python 3.11及以上版本
• uv（Python包管理器）

设置

# リポジトリをクローン
cd claude-edit-mcp

# uv でプロジェクトをインストール
uv sync

使用方法

作为HTTP服务器启动

# デフォルト (127.0.0.1:8000)
uv run claude-edit-mcp

# カスタムホスト・ポート
uv run claude-edit-mcp --host 0.0.0.0 --port 5000

以Stdio模式启动

# MCP プロトコル経由で直接使用
uv run claude-edit-mcp --mode stdio

# または専用コマンド
uv run claude-edit-mcp-stdio

API 端点

文件加载

curl -X POST http://localhost:8000/read_file \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/file.py"
  }'

也可以通过行号和行数来指定范围:

# 10行目から20行分を読み込む
curl -X POST http://localhost:8000/read_file \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/file.py",
    "start_line": 10,
    "num_lines": 20
  }'

注：制表符将自动转换为4个空格。响应中包含元数据（total_lines， start_line， end_line， num_lines_read）也包含在内。

字符串替换

curl -X POST http://localhost:8000/edit_file \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/file.txt",
    "old_string": "古い文字列",
    "new_string": "新しい文字列"
  }'

注：: old_string以及new_string请使用4个空格。制表符将自动转换为4个空格进行搜索。

文件写入

curl -X POST http://localhost:8000/write_file \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/file.txt",
    "content": "ファイルの内容"
  }'

行置换

curl -X POST http://localhost:8000/replace_line \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/file.txt",
    "line_number": 5,
    "new_line": "新しい行の内容"
  }'

Claude Code MCP 集成

若要将 Claude Code 用作 MCP，请编辑设置文件：

{
  "mcpServers": {
    "claude-edit": {
      "command": "uv",
      "args": ["run", "claude-edit-mcp"],
      "env": {
        "CLAUDE_EDIT_HOST": "127.0.0.1",
        "CLAUDE_EDIT_PORT": "8000"
      }
    }
  }
}

故障排除

找不到文件的错误

• 确认文件路径正确
• 确认父目录存在

关于缩进转换的问题

• 详情如下 《缩进转换指南》.md 请参考
• 文件将按标签保存
• 请在所有API调用中使用4个空格

编码错误

• 所有文件均以UTF-8编码
• 如需不同编码，请扩展功能

端口已被使用

uv run claude-edit-mcp --port 8001

开发

执行测试

uv run pytest

软件包更新

uv sync

许可证

麻省理工学院（MIT）