Claude-Code-Workflow/docs/zh/mcp/tools.md

MCP 工具参考

模型上下文协议 (MCP) 工具提供与外部系统和服务的增强集成。

什么是 MCP?

MCP 是一种协议，允许 CCW 通过标准化接口与外部工具、数据库和服务交互。

可用的 MCP 工具

文件操作

mcp__ccw-tools__read_file

读取支持分页的文件内容。

{
  "name": "read_file",
  "parameters": {
    "path": "string (必需)",
    "offset": "number (可选)",
    "limit": "number (可选)"
  }
}

用法:

read_file({ path: "src/index.ts" })
read_file({ path: "large-file.log", offset: 100, limit: 50 })

mcp__ccw-tools__write_file

写入或覆盖文件，支持目录创建。

{
  "name": "write_file",
  "parameters": {
    "path": "string (必需)",
    "content": "string (必需)",
    "createDirectories": "boolean (默认: true)",
    "backup": "boolean (默认: false)"
  }
}

用法:

write_file({
  path: "src/new-file.ts",
  content: "// TypeScript 代码在这里"
})

mcp__ccw-tools__edit_file

使用字符串替换或基于行的操作编辑文件。

{
  "name": "edit_file",
  "parameters": {
    "path": "string (必需)",
    "mode": "update | line (默认: update)",
    "oldText": "string (更新模式)",
    "newText": "string (更新模式)",
    "line": "number (行模式)",
    "operation": "insert_before | insert_after | replace | delete (行模式)"
  }
}

用法:

// 更新模式 - 字符串替换
edit_file({
  path: "config.json",
  oldText: '"version": "1.0.0"',
  newText: '"version": "2.0.0"'
})

// 行模式 - 在第 10 行后插入
edit_file({
  path: "index.ts",
  mode: "line",
  operation: "insert_after",
  line: 10,
  text: "// 新代码在这里"
})

搜索工具

mcp__ccw-tools__smart_search

统一搜索，支持内容搜索、文件发现和语义搜索。

{
  "name": "smart_search",
  "parameters": {
    "action": "search | find_files | init | status",
    "query": "string (用于搜索)",
    "pattern": "glob 模式 (用于 find_files)",
    "mode": "fuzzy | semantic (默认: fuzzy)",
    "output_mode": "full | files_only | count",
    "maxResults": "number (默认: 20)"
  }
}

用法:

// 模糊搜索 (默认)
smart_search({
  action: "search",
  query: "身份验证逻辑"
})

// 语义搜索
smart_search({
  action: "search",
  query: "如何处理错误",
  mode: "semantic"
})

// 按模式查找文件
smart_search({
  action: "find_files",
  pattern: "*.ts"
})

代码上下文

mcp__ace-tool__search_context

使用实时代码库索引的语义代码搜索。

{
  "name": "search_context",
  "parameters": {
    "project_root_path": "string (必需)",
    "query": "string (必需)"
  }
}

用法:

search_context({
  project_root_path: "/path/to/project",
  query: "用户身份验证在哪里处理?"
})

记忆工具

mcp__ccw-tools__core_memory

跨会话记忆管理，用于战略上下文。

{
  "name": "core_memory",
  "parameters": {
    "operation": "list | import | export | summary | embed | search",
    "text": "string (用于导入)",
    "id": "string (用于导出/摘要)",
    "query": "string (用于搜索)"
  }
}

用法:

// 列出所有记忆
core_memory({ operation: "list" })

// 导入新记忆
core_memory({
  operation: "import",
  text: "重要: 使用 JWT 进行身份验证"
})

// 搜索记忆
core_memory({
  operation: "search",
  query: "身份验证"
})

MCP 配置

在 ~/.claude/mcp.json 中配置 MCP 服务器:

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
    },
    "git": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-git"]
    }
  }
}

工具优先级

使用 CCW 时，遵循此工具选择优先级:

1. MCP 工具 (最高优先级) - 用于代码搜索、文件操作
2. 内置工具 - 用于简单、直接的操作
3. Shell 命令 - MCP 不可用时的回退

::: info 另请参阅

• CLI 参考 - CLI 工具使用
• 代理 - 代理工具集成 :::