mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-01 15:03:57 +08:00
c3ddf7e322
- Add docs directory with VitePress configuration - Add GitHub Actions workflow for docs build and deploy - Support bilingual (English/Chinese) documentation - Include search, custom theme, and responsive design
222 lines
4.2 KiB
Markdown
222 lines
4.2 KiB
Markdown
# MCP 工具参考
|
|
|
|
模型上下文协议 (MCP) 工具提供与外部系统和服务的增强集成。
|
|
|
|
## 什么是 MCP?
|
|
|
|
MCP 是一种协议，允许 CCW 通过标准化接口与外部工具、数据库和服务交互。
|
|
|
|
## 可用的 MCP 工具
|
|
|
|
### 文件操作
|
|
|
|
#### mcp__ccw-tools__read_file
|
|
读取支持分页的文件内容。
|
|
|
|
```json
|
|
{
|
|
"name": "read_file",
|
|
"parameters": {
|
|
"path": "string (必需)",
|
|
"offset": "number (可选)",
|
|
"limit": "number (可选)"
|
|
}
|
|
}
|
|
```
|
|
|
|
**用法:**
|
|
```javascript
|
|
read_file({ path: "src/index.ts" })
|
|
read_file({ path: "large-file.log", offset: 100, limit: 50 })
|
|
```
|
|
|
|
#### mcp__ccw-tools__write_file
|
|
写入或覆盖文件，支持目录创建。
|
|
|
|
```json
|
|
{
|
|
"name": "write_file",
|
|
"parameters": {
|
|
"path": "string (必需)",
|
|
"content": "string (必需)",
|
|
"createDirectories": "boolean (默认: true)",
|
|
"backup": "boolean (默认: false)"
|
|
}
|
|
}
|
|
```
|
|
|
|
**用法:**
|
|
```javascript
|
|
write_file({
|
|
path: "src/new-file.ts",
|
|
content: "// TypeScript 代码在这里"
|
|
})
|
|
```
|
|
|
|
#### mcp__ccw-tools__edit_file
|
|
使用字符串替换或基于行的操作编辑文件。
|
|
|
|
```json
|
|
{
|
|
"name": "edit_file",
|
|
"parameters": {
|
|
"path": "string (必需)",
|
|
"mode": "update | line (默认: update)",
|
|
"oldText": "string (更新模式)",
|
|
"newText": "string (更新模式)",
|
|
"line": "number (行模式)",
|
|
"operation": "insert_before | insert_after | replace | delete (行模式)"
|
|
}
|
|
}
|
|
```
|
|
|
|
**用法:**
|
|
```javascript
|
|
// 更新模式 - 字符串替换
|
|
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
|
|
统一搜索，支持内容搜索、文件发现和语义搜索。
|
|
|
|
```json
|
|
{
|
|
"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)"
|
|
}
|
|
}
|
|
```
|
|
|
|
**用法:**
|
|
```javascript
|
|
// 模糊搜索 (默认)
|
|
smart_search({
|
|
action: "search",
|
|
query: "身份验证逻辑"
|
|
})
|
|
|
|
// 语义搜索
|
|
smart_search({
|
|
action: "search",
|
|
query: "如何处理错误",
|
|
mode: "semantic"
|
|
})
|
|
|
|
// 按模式查找文件
|
|
smart_search({
|
|
action: "find_files",
|
|
pattern: "*.ts"
|
|
})
|
|
```
|
|
|
|
### 代码上下文
|
|
|
|
#### mcp__ace-tool__search_context
|
|
使用实时代码库索引的语义代码搜索。
|
|
|
|
```json
|
|
{
|
|
"name": "search_context",
|
|
"parameters": {
|
|
"project_root_path": "string (必需)",
|
|
"query": "string (必需)"
|
|
}
|
|
}
|
|
```
|
|
|
|
**用法:**
|
|
```javascript
|
|
search_context({
|
|
project_root_path: "/path/to/project",
|
|
query: "用户身份验证在哪里处理?"
|
|
})
|
|
```
|
|
|
|
### 记忆工具
|
|
|
|
#### mcp__ccw-tools__core_memory
|
|
跨会话记忆管理，用于战略上下文。
|
|
|
|
```json
|
|
{
|
|
"name": "core_memory",
|
|
"parameters": {
|
|
"operation": "list | import | export | summary | embed | search",
|
|
"text": "string (用于导入)",
|
|
"id": "string (用于导出/摘要)",
|
|
"query": "string (用于搜索)"
|
|
}
|
|
}
|
|
```
|
|
|
|
**用法:**
|
|
```javascript
|
|
// 列出所有记忆
|
|
core_memory({ operation: "list" })
|
|
|
|
// 导入新记忆
|
|
core_memory({
|
|
operation: "import",
|
|
text: "重要: 使用 JWT 进行身份验证"
|
|
})
|
|
|
|
// 搜索记忆
|
|
core_memory({
|
|
operation: "search",
|
|
query: "身份验证"
|
|
})
|
|
```
|
|
|
|
## MCP 配置
|
|
|
|
在 `~/.claude/mcp.json` 中配置 MCP 服务器:
|
|
|
|
```json
|
|
{
|
|
"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/commands.md) - CLI 工具使用
|
|
- [代理](../agents/) - 代理工具集成
|
|
:::
|