12.3 MCP 服务器管理

学习如何管理已配置的 MCP 服务器，包括列出、查看详情、删除和检查状态。

列出服务器

列出所有服务器

claude mcp list

**输出示例** :

    bash


    已配置的 MCP 服务器：

    本地范围：
    - github: https://api.githubcopilot.com/mcp/
    - sentry: https://mcp.sentry.dev/mcp

    项目范围：
    - database: stdio server
    - api: http server

    用户范围：
    - formatter: stdio server

### 列出特定范围的服务器

# 列出本地范围服务器


claude mcp list --scope local

# 列出项目范围服务器

claude mcp list --scope project

# 列出用户范围服务器

claude mcp list --scope user

    bash


    ## 获取服务器详情

    ### 基本用法

    claude mcp get <server-name>

### 示例：查看 GitHub 服务器详情

    bash


    claude mcp get github

**输出示例** :

    bash


    服务器名称: github
    传输方式: http
    URL: https://api.githubcopilot.com/mcp/
    范围: local
    状态: 已连接
    工具: 15
    资源: 5

### 示例：查看数据库服务器详情

    bash


    claude mcp get database

**输出示例** :

    bash


    服务器名称: database
    传输方式: stdio
    命令: npx -y @bytebase/dbhub
    参数: --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
    范围: project
    状态: 已连接
    工具: 8
    资源: 3

## 删除服务器

### 基本用法

    bash


    claude mcp remove <server-name>

### 示例：删除 GitHub 服务器

    bash


    claude mcp remove github

**输出** :

    bash


    确认删除服务器 github? (y/n): y
    服务器 github 已成功删除

### 删除特定范围的服务器

    bash


    # 删除本地范围服务器
    claude mcp remove github --scope local

    # 删除项目范围服务器
    claude mcp remove database --scope project

    # 删除用户范围服务器
    claude mcp remove formatter --scope user

### 批量删除

    bash


    # 删除多个服务器
    claude mcp remove github sentry database

## 检查服务器状态

### 在 Claude Code 中检查

    bash


    /mcp

**输出示例** :

    bash


    MCP 服务器状态：
    本地范围：
    ✅ github: 已连接 (15 工具, 5 资源)
    ✅ sentry: 已连接 (10 工具, 3 资源)
    项目范围：
    ✅ database: 已连接 (8 工具, 3 资源)
    ❌ api: 连接错误
    用户范围：
    ✅ formatter: 已连接 (5 工具, 0 资源)

### 检查特定服务器状态

    bash


    # 检查 GitHub 服务器状态
    claude mcp get github

**输出示例** :

    bash


    GitHub 服务器状态：
    - 状态: 已连接
    - 响应时间: 100ms
    - 最后检查: 2 分钟前
    - 工具数量: 15
    - 资源数量: 5

## 测试服务器连接

### 测试所有服务器

    bash


    # 测试所有 MCP 服务器连接
    claude mcp list

**输出示例** :

    bash


    测试 MCP 服务器连接：
    ✅ github: 连接成功 (50ms)
    ✅ sentry: 连接成功 (80ms)
    ✅ database: 连接成功 (30ms)
    ❌ api: 连接失败 - 超时

### 测试特定服务器

    bash


    # 测试 GitHub 服务器连接
    claude mcp get github

**输出示例** :

    bash


    测试 GitHub 服务器连接：
    ✅ 连接成功
    响应时间: 50ms
    服务器版本: 1.2.3

## 更新服务器配置

### 更新 HTTP 服务器

    bash


    # 删除旧配置
    claude mcp remove github

    # 添加新配置
    claude mcp add --transport http github https://api.githubcopilot.com/mcp/v2

### 更新 stdio 服务器

    bash


    # 删除旧配置
    claude mcp remove database

    # 添加新配置
    claude mcp add --transport stdio database \
    --env DB_URL=new-db-url \
    -- npx -y @bytebase/dbhub

### 更新环境变量

    bash


    # 对于项目范围服务器，编辑 .mcp.json
    vim .mcp.json

    json


    {
      "mcpServers": {
        "database": {
          "command": "npx",
          "args": ["-y", "@bytebase/dbhub"],
          "env": {
            "DB_URL": "${NEW_DB_URL:-postgresql://localhost/db}"
          }
        }
      }
    }

## 重置配置

### 重置项目选择

    bash


    claude mcp reset-project-choices

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269

此命令将清除所有项目范围 MCP 服务器的批准选择。

yaml

### 重置所有配置

    bash


    # 删除所有本地范围服务器
    claude mcp list --scope local | awk '{print $1}' | xargs claude mcp remove

    # 删除所有用户范围服务器
    claude mcp list --scope user | awk '{print $1}' | xargs claude mcp remove

## 监控服务器性能

### 查看性能统计

    bash


    # 显示 MCP 服务器性能统计
    claude mcp list

**输出示例** :

    bash


    MCP 服务器性能统计：

    github:
    - 平均响应时间: 100ms
    - 总调用次数: 150
    - 成功率: 99.3%
    - 最后调用: 1 分钟前

    sentry:
    - 平均响应时间: 200ms
    - 总调用次数: 50
    - 成功率: 100%
    - 最后调用: 5 分钟前

    database:
    - 平均响应时间: 50ms
    - 总调用次数: 300
    - 成功率: 98.7%
    - 最后调用: 30 秒前

### 查看错误日志

    bash


    # 显示 MCP 服务器错误日志
    claude --verbose

**输出示例** :

    bash


    MCP 服务器错误日志：

    api:
    - [2024-01-15 10:30:00] 连接超时
    - [2024-01-15 10:35:00] API 限流

    database:
    - [2024-01-15 10:20:00] 查询超时
    - [2024-01-15 10:25:00] 连接失败

## 故障排除

### 服务器连接失败


**问题** : 服务器无法连接

**解决方案** :

    bash


    # 1. 检查服务器状态
    /mcp

    # 2. 测试连接
    claude mcp list

    # 3. 查看错误日志
    claude --verbose

    # 4. 验证配置
    claude mcp get server-name

    # 5. 重新配置服务器
    claude mcp remove server-name
    claude mcp add --transport http server-name <url>

### 服务器响应缓慢


**问题** : 服务器响应时间过长

**解决方案** :

    bash


    # 1. 查看性能统计
    claude mcp list

    # 2. 检查网络连接
    ping api.example.com

    # 3. 增加超时设置
    MCP_TIMEOUT=30000 claude

    # 4. 优化服务器配置
    # 考虑使用更快的传输方式

### 工具调用失败


**问题** : MCP 工具调用失败

**解决方案** :

    bash


    # 1. 检查服务器状态
    /mcp

    # 2. 验证工具参数
    # 检查工具参数

    # 3. 查看错误日志
    claude --verbose

    # 4. 重试工具调用
    # 重试工具调用

### 配置文件错误

问题 : .mcp.json 配置文件有错误

bash

**解决方案** :

    bash


    # 1. 验证 JSON 语法
    cat .mcp.json | jq .

    # 2. 检查环境变量
    echo $API_KEY

    # 3. 查看错误日志
    claude --verbose

    # 4. 修复配置文件
    vim .mcp.json

## 最佳实践

### 1\. 定期检查服务器状态

    bash


    # 每天检查一次
    /mcp

### 2\. 监控性能

    bash


    # 定期查看性能统计
    claude mcp list

    # 识别慢速服务器
    # 优化配置或更换服务器

### 3\. 及时删除不需要的服务器

    bash


    # 定期清理不使用的服务器
    claude mcp list
    claude mcp remove unused-server

### 4\. 备份配置

    bash


    # 备份 .mcp.json
    cp .mcp.json .mcp.json.backup

    # 备份用户配置
    cp ~/.claude/mcp.json ~/.claude/mcp.json.backup

### 5\. 文档化配置

    bash


    # 创建配置文档
    echo "MCP 服务器配置说明" > MCP_CONFIG.md
    echo "- github: 用于代码审查" >> MCP_CONFIG.md
    echo "- database: 用于数据查询" >> MCP_CONFIG.md

## 自动化管理

### 使用脚本管理

    bash


    #!/bin/bash
    # mcp-manager.sh

    # 列出服务器
    list_servers() {
        claude mcp list
    }

    # 添加服务器
    add_server() {
        claude mcp add "$@"
    }

    # 删除服务器
    remove_server() {
        claude mcp remove "$@"
    }

    # 检查状态
    check_status() {
        echo "> /mcp" | claude
    }

    # 主函数
    case "$1" in
        list) list_servers ;;
        add) shift; add_server "$@" ;;
        remove) shift; remove_server "$@" ;;
        status) check_status ;;
        *) echo "用法: $0 {list|add|remove|status}" ;;
    esac

### 定期维护

    bash


    #!/bin/bash
    # mcp-maintenance.sh

    # 检查所有服务器状态
    echo "检查 MCP 服务器状态..."
    claude mcp list

    # 测试连接
    echo "测试服务器连接..."
    claude mcp list

    # 查看性能统计
    echo "查看性能统计..."
    claude mcp list

    # 备份配置
    echo "备份配置..."
    cp ~/.claude/mcp.json ~/.claude/mcp.json.backup.$(date +%Y%m%d)

### 设置定时任务

    bash


    # 添加到 crontab
    crontab -e

    # 每天凌晨 2 点运行维护脚本
    0 2 * * * /path/to/mcp-maintenance.sh

12.3 MCP 服务器管理 ​

列出服务器 ​

列出所有服务器 ​

12.3 MCP 服务器管理

列出服务器

列出所有服务器