Code Tools MCP

一个整合了文件阅读和代码搜索功能的 MCP (Model Context Protocol) 服务工具。

功能概述

本 MCP 服务注册了两个工具，供支持 MCP 协议的 AI 客户端（如 Claude Desktop、Claude Code 等）调用：

读取指定路径的文件内容，支持按行范围分页读取。

参数：

参数	类型	必填	说明
`file_path`	string	是	文件的绝对或相对路径，支持跨盘符路径（如 `D:/path/to/file`）
`offset`	number	否	起始行号（从 1 开始），配合 `limit` 实现分页读取
`limit`	number	否	最大读取行数，配合 `offset` 实现分页读取

示例：

{
  "file_path": "D:/projects/main.cpp",
  "offset": 100,
  "limit": 50
}

在指定目录中递归搜索匹配正则表达式的内容，基于 grep 实现。

参数：

参数	类型	必填	说明
`query`	string	是	grep 兼容的搜索查询（支持正则表达式）
`directory`	string	否	搜索目录，支持绝对/相对路径，默认为当前工作目录
`include`	string	否	文件类型过滤（如 `.js`、`.cpp`），对应 grep 的 `--include`

示例：

{
  "query": "function\\s+loadNextLevel",
  "directory": "D:/raylib/proj_1",
  "include": "*.cpp"
}

cd D:/code-tools-mcp
npm install

在 Claude Desktop 或 Claude Code 的 MCP 配置中添加：

{
  "mcpServers": {
    "code-tools": {
      "command": "node",
      "args": ["D:/code-tools-mcp/index.js"]
    }
  }
}

node D:/code-tools-mcp/index.js

code-tools-mcp/
├── index.js        # MCP 服务主入口，注册 read_file 和 search_codebase 两个工具
├── package.json    # 项目配置文件
└── README.md       # 本说明文件