MCP检查器MCP服务器
AI从代理MCP可调试和检查服务器的新一代调试工具
MCP Inspector功能MCP作为服务器提供AI从代理(例如,Claude Desktop)MCP它是一种创新的工具,可以直接调试和检查服务器。
📖 目次
- 概要
- MCP(Model Context Protocol)所谓
- 主要机能
- 安装
- 快速启动
- 配置指南
- 使用例
- 交付工具详细信息
- 性能特性
- 故障排除
- 常见问题解答
- 开発情报
- 许可证
- 参考链接
概要
此项目包括:MCP检查员的,之CLI模式功能MCP服务器化的东西。AI从代理(例如,Claude Desktop)MCP可以获取或运行服务器的工具列表。
体系结构图```
AIエージェント (Claude Desktop)
↓ MCP Protocol
本MCPサーバー (mcp_inspector_mcp) ← このプロジェクト
↓ MCP Protocol
対象MCPサーバー (fundamental_analysis, filesystem, etc.)
### 目标用户
- MCP服务器开发人员-简化调试和测试
- AI代理用户-已连接MCP服务器调查
- 系统集成器-多个MCP服务器集成管理
### 用例
1. **开发中的MCP调试服务器**:实时查看工具运行结果
1. **健康检查**:生产环境MCP监视服务器运行状况
1. **设定検证**:服务器capability和版本信息
1. **日志调查**:收集和分析从服务器发送的日志消息
1. **性能测量**:定期监视响应时间和错误率
______________________________________________________________________
## MCP(Model Context Protocol)所谓
**模型上下文协议(MCP)** 单击功能区上AI用于连接应用程序和数据源的标准化开放协议。
### MCP特征
- **标准化**:在统一的界面中集成不同的工具
- **扩张性**:可自由添加自定义工具、资源和提示
- **安全性**:在沙箱环境中安全运行
- **双方向通信**: AI支持与工具交互
### MCP组件
1. **Tools(工具)**: AI可执行的功能(例如:文件读写、API调用)
1. **Resources(资源)**: AI可引用的数据(例如文件、数据库)
1. **Prompts(提示**:预定义提示模板
1. **采样**: AI一方在服务器上LLM委托推理的功能(高级功能)
### 本项目的角色
MCP Inspector MCP单击功能区上**MCP服务器调试专用MCP服务器**是。其他MCP可以将服务器作为检查对象,调查其内部状态和功能。
______________________________________________________________________
## 主要机能
### ✅ 已安装功能(v0.4.0)
#### Phase 1: 工具检查功能
- `tools_list` -目标MCP获取服务器工具列表
- `tools_call` -目标MCP运行服务器工具
#### Phase 2: 资源提示检查功能
- `resources_list` -资源列表检索
- `resources_read` -资源读取
- `prompts_list` -获取提示列表
- `prompts_get` -提示检索
#### Phase 3: 功能扩展阶段(v0.4.0)
- **调试模式** -详细日志和请求/响应可视化
- `--verbose`用标志显示详细日志
- 格式化请求/响应
- 显示计时信息
- 日志文件输出
- **批量测试功能** - CI/CD集成和测试自动化
- YAML/JSON格式测试定义
- 12种断言
- 并列/顺次実行
- 3种报告格式(Console/JSON/JUnit XML)
- **性能监控** -实时度量收集
- 实时测量收集
- 基于时间窗的统计
- 多格式报告生成(Console/JSON/HTML)
- 自动瓶颈检测
- **构成管理扩张** -灵活的环境设置管理
- 配置文件功能(dev/staging/prod)
- 按环境切换设置
- 导入/导出设置(JSON/YAML)
- 配置模板功能
#### Sampling记录功能
- `sampling_logs` - Sampling记录请求
- MonitoringTransport - Transport层でのSampling监视
#### Phase 5: 性能优化
- **连接滑轮** - MCP客户端连接重用(第二次以后加快50%以上)
- **高速缓存** - TTL基本响应高速缓存(高速缓存命中时\<1ms)
- **并列处理** -多服务器并行处理(N个服务器处理约为1/N的时间)
- **日志后端抽象** - Memory/Persistent灵活的后端切换
#### Phase 6: 服务器检查功能
- `server_inspect` -服务器设置和capability检查
- `health_check` -健康检查和性能测量
- `logging_messages` -日志消息检查和过滤
#### Phase 7: 错误处理(v0.3.1)
- 结构化错误报告
- 超时检测和详细信息提供
- Capability验证和尽力执行
#### Phase 8: 设定管理(v0.3.0)
- `.inspector/config.json` 方式统一的设置管理
- `config_add_server` / `config_remove_server` / `config_list_servers` - AI直接从代理进行设置操作
- 定制运行时设置(超时、重试等)
### 🔧 提供工具列表(共15个工具)
|类别|工具名称|说明|
**Tools検查** · `tools_list` 获取工具列表
`tools_call` 工具执行
**Resources検查** · `resources_list` 获取资源列表
`resources_read` 资源读取
**Prompts検查** · `prompts_list` |获取提示列表|
`prompts_get` |获取提示|
**Sampling検查** · `sampling_logs` · Sampling日志获取
**服务器检查** · `server_inspect` |服务器设置检查|
`health_check` |健康检查|
`logging_messages` 获取日志消息
**设定管理** · `config_add_server` |添加服务器|
`config_remove_server` 服务器删除
`config_list_servers` 服务器列表
**并列处理** · `list_tools_batch` |并行获取多个服务器的工具列表|
`list_resources_batch` |并行获取多个服务器的资源列表|
______________________________________________________________________
## 安装
### 前提条件
使用本项目需要以下环境:
- **锈** 1.70以上(生锈安装)
- **货物**(Rust),模板名称将采用不同的格式
- **克劳德桌面**(或其他MCP应对AI客户机)
- **检查对象的MCP服务器**(别途用意)
#### Rust安装
**窗户:**```bash
# PowerShellで実行
# https://rustup.rs/ から rustup-init.exe をダウンロードして実行
macOS/Linux:```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
#### 安装确认```bash
rustc --version # rust 1.70.0 以上
cargo --version # cargo 1.70.0 以上
构建过程
1.克隆存储库```bash
git clone https://github.com/yourusername/mcp_inspector_mcp.git
cd mcp_inspector_mcp
#### 2.版本构建```bash
cargo build --release
构建成功后,将生成以下可执行文件:
- 视窗:
target\release\mcp_inspector_mcp.exe - macOS/Linux:
target/release/mcp_inspector_mcp
3.动作确认```bash
ヘルプメッセージの表示
./target/release/mcp_inspector_mcp --help
デバッグモードでの起動確認(すぐにCtrl+Cで終了してOK)
RUST_LOG=info ./target/release/mcp_inspector_mcp
### 故障排除(构建时)
**如果出现编译错误:**```bash
# Rustツールチェインを最新に更新
rustup update
# 依存関係のクリーンビルド
cargo clean
cargo build --release
如果出现网络错误:```bash
cratesのミラーサイトを使用(中国など)
.cargo/config.toml に以下を追加
[source.crates-io]
replace-with = 'mirror'
[source.mirror]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
______________________________________________________________________
## 快速启动
是30分钟以内可以学习基本操作的导游。
### Step 1: 首次启动和配置文件生成
初回起动时、`.inspector/config.json`将条目添加到文档注册表。```bash
# 実行可能ファイルのディレクトリに移動
cd target/release
# 初回起動(設定ファイルが自動生成される)
./mcp_inspector_mcp
自动生成的文件:```
target/release/.inspector/
└── config.json # デフォルト設定
**默认设置:**```json
{
"servers": [],
"logging": {
"backend": "memory",
"db_path": "./data/logs.db",
"max_logs": 10000
}
}
Step 2: 添加要检查的服务器
.inspector/config.json编辑,检查对象的MCP添加服务器。
示例设置(Windows):```json
{
"servers": [
{
"name": "my_first_server",
"transport": "stdio",
"command": "C:\path\to\your\mcp_server.exe",
"args": [],
"env": {}
}
],
"logging": {
"backend": "memory",
"db_path": "./data/logs.db",
"max_logs": 10000
}
}
**示例设置(macOS/Linux):**```json
{
"servers": [
{
"name": "my_first_server",
"transport": "stdio",
"command": "/path/to/your/mcp_server",
"args": [],
"env": {}
}
],
"logging": {
"backend": "memory",
"db_path": "./data/logs.db",
"max_logs": 10000
}
}
重点:
name-服务器的标识符(必须唯一)command-可执行文件的完整路径- Windows那么
\的\\逃生
Step 3: Claude Desktop注册
Claude Desktop配置文件MCP注册服务器。
配置文件位置:
- 视窗:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Windows版设定例:```json
{
"mcpServers": {
"mcp-inspector": {
"command": "C:\Users\YourName\mcp_inspector_mcp\target\release\mcp_inspector_mcp.exe"
}
}
}
**macOS/Linux版设定例:**```json
{
"mcpServers": {
"mcp-inspector": {
"command": "/Users/yourname/mcp_inspector_mcp/target/release/mcp_inspector_mcp"
}
}
}
Step 4: Claude Desktop重新启动
为了反映设定Claude Desktop完全退出并重新启动来修改标记元素的显示属性。
窗户:
- 在动态输入提示中单击Claude Desktop列表框中,此格式对应于条目“无”
- 再度起动
macOS:
- Cmd + Q 的Claude Desktop完全结束
- 再度起动
Step 5: 基本用法
Claude Desktop的聊天画面,请指示以下内容。
示例1:检查已注册服务器的列表```
mcp-inspectorに登録されているサーバーの一覧を教えてください
**内部运行的工具:**```json
{
"name": "config_list_servers",
"arguments": {}
}
示例2:获取服务器工具列表```
"my_first_server"が提供しているツールの一覧を取得してください
**内部运行的工具:**```json
{
"name": "tools_list",
"arguments": {
"server": "my_first_server"
}
}
示例3:健康检查```
"my_first_server"のヘルスチェックを実行してください
**内部运行的工具:**```json
{
"name": "health_check",
"arguments": {
"server": "my_first_server"
}
}
配置指南
.inspector/config.json 详细信息
Phase 8中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。在此文件中管理所有设置。
配置文件位置```
{カレントディレクトリ}/.inspector/config.json
当前目录是包含可执行文件的目录。
#### 基本构成```json
{
"servers": [
{サーバー設定1},
{サーバー設定2},
...
],
"logging": {
ログ設定
},
"execution_config": {
実行設定(オプション)
}
}
服务器设置
检查对象的MCP在数组中定义服务器。
必须项目:
项目 · 型 · 说明 · 例
name · string · 服务器标识名(唯一) "fundamental_analysis"
transport · string · 传输类型(当前为stdio仅) "stdio"
command · string · 可执行文件的完整路径 "C:/path/to/server.exe"
可选项目:
项目 · 型 · 说明 · 例
args · array · 命令行参数 ["--verbose", "--debug"]
env · object · 环境变数 · {"API_KEY": "xxx", "LOG_LEVEL": "debug"}
配置示例(多台服务器):```json
{
"servers": [
{
"name": "fundamental_analysis",
"transport": "stdio",
"command": "C:/projects/fa/target/release/fa.exe",
"args": [],
"env": {
"API_KEY": "your-api-key-here"
}
},
{
"name": "technical_analysis",
"transport": "stdio",
"command": "C:/projects/ta/target/release/ta.exe",
"args": ["--verbose"],
"env": {}
},
{
"name": "filesystem",
"transport": "stdio",
"command": "/usr/local/bin/mcp-filesystem",
"args": [],
"env": {}
}
],
"logging": {
"backend": "memory",
"db_path": "./data/logs.db",
"max_logs": 10000
}
}
### 日志设置
Sampling设置日志和日志消息的保存方法。
**设定项目:**
|项目|类型|说明|默认|
`backend` · string · 日志后端(`memory` / `persistent`) · `"memory"`
`db_path` · string · DB路径(persistent时) `"./data/logs.db"`
`max_logs` · number · 每个服务器的最大日志数 `10000`
#### 内存后端
在内存中保存日志。虽然速度很快,但是重启后会消失。
**推奨环境:** 开发和测试环境
**设定例:**```json
{
"logging": {
"backend": "memory",
"max_logs": 10000
}
}
特徴:
- ✅ 快速读写(1000件/秒以上)
- ✅ 易于配置
- ❌ 重新启动时日志丢失
- ❌ 大量记录时内存使用量增加
持久后端
sled使用数据库保存到磁盘。重新启动后仍保留日志。
推奨环境: 生产环境,需要长期日志保存时
设定例:```json
{
"logging": {
"backend": "persistent",
"db_path": "./data/logs.db",
"max_logs": 10000
}
}
**准备数据库目录:**```bash
# Windowsの場合
mkdir data
# macOS/Linuxの場合
mkdir -p ./data
特徴:
- ✅ 重新启动后仍保留日志
- ✅ 适合保存大量日志
- ✅ 自动圧缩(sled)
- ❌ Memory慢约2倍(500-1000件/秒)
存储大小参考:
- 每10000件约5-10MB(sled已压缩
実行设定(execution_config)
设置工具运行时的超时和重试(可选)。
设定项目:
|项目|类型|说明|默认|环境变量|
tool_timeout_ms · number · 工具执行超时(毫秒) 30000 · MCP_TOOL_TIMEOUT_MS
connection_timeout_ms · number · 连接超时(毫秒) 5000 · MCP_CONNECTION_TIMEOUT_MS
retry_count · number · 重试次数| 0 · MCP_RETRY_COUNT
auto_retry_on_timeout · boolean · 超时时的自动重试 false · MCP_AUTO_RETRY
设定例:```json
{
"servers": [...],
"logging": {...},
"execution_config": {
"tool_timeout_ms": 60000,
"connection_timeout_ms": 10000,
"retry_count": 1,
"auto_retry_on_timeout": false
}
}
**优先顺位:** `config.json` >环境变量>默认值
**使用示例(支持长时间运行工具):**```json
{
"execution_config": {
"tool_timeout_ms": 120000, // 2分
"retry_count": 2,
"auto_retry_on_timeout": true
}
}
AI使用代理设置
AI可通过“代理”(Claude Desktop)直接操作设置。
config_add_server - 添加服务器
使用例:```
"my_new_server"という名前で"C:/path/to/server.exe"をMCP Inspectorに登録してください
**内部运行的工具:**```json
{
"name": "config_add_server",
"arguments": {
"name": "my_new_server",
"transport": "stdio",
"command": "C:/path/to/server.exe",
"args": [],
"env": {}
}
}
config_remove_server - 服务器删除
使用例:```
"my_new_server"をMCP Inspectorから削除してください
**内部运行的工具:**```json
{
"name": "config_remove_server",
"arguments": {
"name": "my_new_server"
}
}
config_list_servers - 服务器列表
使用例:```
MCP Inspectorに登録されているサーバーを教えてください
**内部运行的工具:**```json
{
"name": "config_list_servers",
"arguments": {}
}
使用例
基本用例
示例1:获取工具列表
Claude Desktop中的说明:```
"fundamental_analysis"サーバーが提供しているツールの一覧を取得してください
**运行的工具:**```json
{
"name": "tools_list",
"arguments": {
"server": "fundamental_analysis"
}
}
响应示例:```json
{
"server": "fundamental_analysis",
"tools": [
{
"name": "get_financial_ratios",
"description": "企業の財務比率を取得します",
"input_schema": {
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "ティッカーシンボル(例: AAPL)"
}
},
"required": ["ticker"]
}
},
{
"name": "calculate_dcf",
"description": "DCF法による企業価値評価",
"input_schema": {...}
}
]
}
#### 示例2:运行工具
**Claude Desktop中的说明:**```
"fundamental_analysis"サーバーの"get_financial_ratios"ツールを使って、
AAPLの財務比率を取得してください
运行的工具:```json
{
"name": "tools_call",
"arguments": {
"server": "fundamental_analysis",
"tool_name": "get_financial_ratios",
"arguments": {
"ticker": "AAPL"
}
}
}
**响应示例:**```json
{
"server": "fundamental_analysis",
"tool_name": "get_financial_ratios",
"result": {
"ticker": "AAPL",
"ratios": {
"pe_ratio": 28.5,
"pb_ratio": 42.1,
"debt_to_equity": 1.73,
"roe": 0.147
}
}
}
示例3:获取资源列表
Claude Desktop中的说明:```
"fundamental_analysis"サーバーが提供しているリソースの一覧を教えてください
**运行的工具:**```json
{
"name": "resources_list",
"arguments": {
"server": "fundamental_analysis"
}
}
响应示例:```json
{
"server": "fundamental_analysis",
"resources": [
{
"uri": "file:///data/sp500_list.csv",
"name": "S&P 500 List",
"description": "S&P 500構成銘柄のリスト",
"mime_type": "text/csv"
},
{
"uri": "file:///data/financial_reports/AAPL_2024Q4.json",
"name": "AAPL 2024 Q4 Report",
"description": "Appleの2024年Q4決算レポート",
"mime_type": "application/json"
}
]
}
#### 示例4:读取资源
**Claude Desktop中的说明:**```
"fundamental_analysis"サーバーの"file:///data/sp500_list.csv"リソースを読み込んでください
运行的工具:```json
{
"name": "resources_read",
"arguments": {
"server": "fundamental_analysis",
"uri": "file:///data/sp500_list.csv"
}
}
**响应示例:**```json
{
"server": "fundamental_analysis",
"uri": "file:///data/sp500_list.csv",
"contents": [
{
"uri": "file:///data/sp500_list.csv",
"mime_type": "text/csv",
"text": "Symbol,Name,Sector\nAAPL,Apple Inc.,Technology\nMSFT,Microsoft Corporation,Technology\n...",
"blob": null
}
]
}
示例5:获取提示列表
Claude Desktop中的说明:```
"fundamental_analysis"サーバーが提供しているプロンプトテンプレートの一覧を取得してください
**运行的工具:**```json
{
"name": "prompts_list",
"arguments": {
"server": "fundamental_analysis"
}
}
响应示例:```json
{
"server": "fundamental_analysis",
"prompts": [
{
"name": "analyze_company",
"description": "企業の財務分析を行うプロンプト",
"arguments": [
{
"name": "ticker",
"description": "ティッカーシンボル",
"required": true
},
{
"name": "analysis_type",
"description": "分析タイプ(fundamental/technical)",
"required": false
}
]
}
]
}
### 高级用例
#### 示例6:详细检查服务器设置
**Claude Desktop中的说明:**```
"fundamental_analysis"サーバーの詳細な設定情報を取得してください。
サーバーのバージョン、サポートしている機能、プロトコルバージョンを確認したいです。
运行的工具:```json
{
"name": "server_inspect",
"arguments": {
"server": "fundamental_analysis"
}
}
**响应示例:**```json
{
"server_name": "fundamental_analysis",
"implementation": {
"name": "fundamental-analysis-server",
"title": "Financial Analysis Server",
"version": "1.2.3",
"website_url": "https://example.com"
},
"capabilities": {
"logging": true,
"experimental": false,
"completions": false,
"prompts": {
"supported": true,
"list_changed": false
},
"resources": {
"supported": true,
"subscribe": false,
"list_changed": false
},
"tools": {
"supported": true,
"list_changed": false
}
},
"connection_status": "connected",
"protocol_version": "2024-11-05",
"instructions": null
}
示例7:健康检查和性能测量
Claude Desktop中的说明:```
"fundamental_analysis"サーバーのヘルスチェックを実行して、
レスポンスタイムとエラー率を教えてください
**运行的工具:**```json
{
"name": "health_check",
"arguments": {
"server": "fundamental_analysis"
}
}
响应示例:```json
{
"server_name": "fundamental_analysis",
"status": "healthy",
"response_time_ms": 45,
"last_check": "2025-11-18T10:30:00Z",
"error_count": 0,
"error_rate": 0.0,
"details": null
}
**状态判定标准:**
- **健康的**:响应时间\<500ms 且错误率\<5%
- **退化**:响应时间\<2000ms 且错误率\<20%
- **不健康的**:响应时间>=2000ms 或错误率>=20%
#### 示例8:获取日志消息
**Claude Desktop中的说明:**```
"fundamental_analysis"サーバーから送信されたエラーレベル以上のログメッセージを
最新50件取得してください
运行的工具:```json
{
"name": "logging_messages",
"arguments": {
"server": "fundamental_analysis",
"level": "error",
"limit": 50
}
}
**响应示例:**```json
{
"server_name": "fundamental_analysis",
"messages": [
{
"timestamp": "2025-11-18T10:25:30Z",
"server_name": "fundamental_analysis",
"level": "error",
"logger": "app.api_client",
"message": "Failed to fetch data from external API: timeout"
},
{
"timestamp": "2025-11-18T10:22:15Z",
"server_name": "fundamental_analysis",
"level": "error",
"logger": "app.database",
"message": "Database connection lost, retrying..."
}
],
"total_count": 2
}
示例9:多服务器并行处理
Claude Desktop中的说明:```
["fundamental_analysis", "technical_analysis", "filesystem"]の3つのサーバーの
ツール一覧を一度に取得してください
**运行的工具:**```json
{
"name": "list_tools_batch",
"arguments": {
"servers": ["fundamental_analysis", "technical_analysis", "filesystem"]
}
}
响应示例:```json
{
"results": [
{
"server": "fundamental_analysis",
"tools": [...]
},
{
"server": "technical_analysis",
"tools": [...]
},
{
"server": "filesystem",
"tools": [...]
}
],
"errors": []
}
**性能:**
- 在大约1/3的时间内完成并行处理三台服务器
- 如果发生错误,其他服务器将返回结果
#### 示例10:Sampling获取日志
**Claude Desktop中的说明:**```
"fundamental_analysis"サーバーのSamplingリクエストログを最新10件取得してください
运行的工具:```json
{
"name": "sampling_logs",
"arguments": {
"server": "fundamental_analysis",
"limit": 10,
"status": "all"
}
}
**⚠️ 注意:** 现在、rmcp 0.8.5的技术约束Sampling未安装通信监视。仅提供日志管理基础设施。
______________________________________________________________________
## 交付工具详细信息
### Phase 1: Tools検查机能
#### 工具列表
对象MCP获取服务器提供的工具列表。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
**返回值:**```json
{
"server": "fundamental_analysis",
"tools": [
{
"name": "tool_name",
"description": "Tool description",
"input_schema": {
"type": "object",
"properties": {...},
"required": [...]
}
}
]
}
使用例:```
"fundamental_analysis"サーバーのツール一覧を取得してください
**缓存:**
- 默认TTL: 5分钟
- 高速缓存命中时:\<1ms
#### 工具_调用
对象MCP运行服务器的特定工具。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
`tool_name` · string · ✅ · 要运行的工具名称 `"calculate_rsi"`
`arguments` · object · ❌ · 传递给工具的参数 `{"symbol": "AAPL", "period": 14}`
**返回值:**```json
{
"server": "fundamental_analysis",
"tool_name": "calculate_rsi",
"result": {
"symbol": "AAPL",
"rsi": 65.3,
"status": "overbought"
}
}
使用例:```
"fundamental_analysis"サーバーの"calculate_rsi"ツールを
引数 {"symbol": "AAPL", "period": 14} で実行してください
**超时:**
- 默认值:30秒
- 可通过配置进行自定义(`execution_config.tool_timeout_ms`)
**错误处理:**
- 超时:返回详细的错误信息
- 服务器崩溃:包含错误类型和建议的报告
### Phase 2: Resources・Prompts検查机能
#### 资源列表
对象MCP获取服务器提供的资源列表。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
**返回值:**```json
{
"server": "fundamental_analysis",
"resources": [
{
"uri": "file:///path/to/resource",
"name": "Resource Name",
"description": "Resource description",
"mime_type": "text/plain"
}
]
}
使用例:```
"fundamental_analysis"サーバーのリソース一覧を取得してください
#### 资源_阅读
对象MCP加载服务器的特定资源。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
`uri` · string · ✅ · 资源URI · `"file:///data/sp500.csv"`
**返回值:**```json
{
"server": "fundamental_analysis",
"uri": "file:///data/sp500.csv",
"contents": [
{
"uri": "file:///data/sp500.csv",
"mime_type": "text/csv",
"text": "Symbol,Name,Sector\nAAPL,Apple Inc.,Technology\n...",
"blob": null
}
]
}
使用例:```
"fundamental_analysis"サーバーの"file:///data/sp500.csv"リソースを読み込んでください
#### prompts_list
对象MCP获取服务器提供的提示模板列表。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
**返回值:**```json
{
"server": "fundamental_analysis",
"prompts": [
{
"name": "analyze_company",
"description": "企業分析を行うプロンプト",
"arguments": [
{
"name": "ticker",
"description": "ティッカーシンボル",
"required": true
}
]
}
]
}
使用例:```
"fundamental_analysis"サーバーのプロンプトテンプレート一覧を取得してください
#### prompts_get
对象MCP获取服务器的特定提示模板。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
`name` · string · ✅ · 提示名称| `"analyze_company"`
`arguments` · object · ❌ · 要传递给提示的参数 `{"ticker": "AAPL"}`
**返回值:**```json
{
"server": "fundamental_analysis",
"name": "analyze_company",
"messages": [
{
"role": "user",
"content": {
"type": "text",
"text": "Analyze AAPL company using fundamental analysis..."
}
}
]
}
使用例:```
"fundamental_analysis"サーバーの"analyze_company"プロンプトを
引数 {"ticker": "AAPL"} で取得してください
### Phase 3: Sampling検查机能
#### 采样日志
对象MCP从服务器Sampling获取请求的日志。
**⚠️ 重要限制:** rmcp 0.8.5的技术约束Sampling未安装通信监视。仅提供日志管理基础设施。
**引数:**
|名称|类型|必需|说明|默认|
`server` · string · ✅ · 目标服务器名称|-|
`limit` · integer · ❌ · 获取的最大日志数 `100`
`status` · string · ❌ · 筛选状态(`all` / `success` / `failed`) · `"all"`
**返回值:**```json
{
"server": "fundamental_analysis",
"logs": [
{
"timestamp": "2025-11-18T12:00:00Z",
"server_name": "fundamental_analysis",
"request_id": "uuid-here",
"model_preferences": {
"hints": [],
"cost_priority": null,
"speed_priority": null,
"intelligence_priority": null
},
"system_prompt": null,
"messages": [],
"max_tokens": 1024,
"status": "Pending",
"error_message": null
}
],
"total_count": 1
}
使用例:```
"fundamental_analysis"サーバーのSamplingログを最新10件取得してください
### Phase 6: 服务器检查功能
#### 服务器扫描
对象MCP详细获取服务器设置信息和功能。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
**返回值:**```json
{
"server_name": "fundamental_analysis",
"implementation": {
"name": "fundamental-analysis-server",
"title": "Financial Analysis Server",
"version": "1.0.0",
"website_url": "https://example.com"
},
"capabilities": {
"logging": false,
"experimental": false,
"completions": false,
"prompts": {
"supported": true,
"list_changed": false
},
"resources": {
"supported": true,
"subscribe": false,
"list_changed": false
},
"tools": {
"supported": true,
"list_changed": false
}
},
"connection_status": "connected",
"protocol_version": "2024-11-05",
"instructions": null
}
使用例:```
"fundamental_analysis"サーバーの設定情報を取得してください
**用途:**
- 检查服务器支持的功能
- 确认协议版本
- 连接状态诊断
#### 健康检查
对象MCP执行服务器的健康检查,进行沟通确认和性能测定。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`server` · string · ✅ · 目标服务器名称| `"fundamental_analysis"`
**返回值:**```json
{
"server_name": "fundamental_analysis",
"status": "healthy",
"response_time_ms": 45,
"last_check": "2025-11-18T10:30:00Z",
"error_count": 0,
"error_rate": 0.0,
"details": null
}
状态确定:
- 健康的:响应时间\<500ms 且错误率\<5%
- 退化:响应时间\<2000ms 且错误率\<20%
- 不健康的:响应时间>=2000ms 或错误率>=20%
使用例:```
"fundamental_analysis"サーバーのヘルスチェックを実行してください
**机能详细:**
- Ping的沟通确认
- 以毫秒为单位的响应时间测量
- 从最近100个历史记录计算错误率
- 使用循环缓冲区自动管理历史记录
#### 日志_消息
对象MCP获取从服务器发送的日志消息。
**引数:**
|名称|类型|必需|说明|默认|
`server` · string · ✅ · 目标服务器名称|-|
`level` · string · ❌ · 最小日志级别(`debug` / `info` / `warning` / `error` 等)|全部|
`limit` · integer · ❌ · 获取的最大日志数 `100`
`since` · string · ❌ · 开始时刻(RFC3339形式)
**返回值:**```json
{
"server_name": "fundamental_analysis",
"messages": [
{
"timestamp": "2025-11-18T10:30:00Z",
"server_name": "fundamental_analysis",
"level": "info",
"logger": "app.service",
"message": "Request processed successfully"
}
],
"total_count": 1
}
日志级别列表(按优先级):
debug-调试消息info-信息消息notice-通知消息warning-警告消息error-错误消息critical-致命错误alert-警报emergency-紧急事态
使用例:```
"fundamental_analysis"サーバーのエラーレベル以上のログを最新50件取得してください
**技术详细:**
- `notifications/message`遵守协议
- MonitoringTransportで自动検出・记録
- Memory/Persistent支持后端
### Phase 8: 配置管理工具
#### config_add_server
服务器设置`.inspector/config.json`中所述修改相应参数的值。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`name` · string · ✅ · 服务器标识名(唯一) `"my_server"`
`transport` · string · ✅ · 传输类型 `"stdio"`
`command` · string · ✅ · 可执行文件路径 `"C:/path/to/server.exe"`
`args` · array · ❌ · 命令行参数 `["--verbose"]`
`env` · object · ❌ · 环境变数 · `{"API_KEY": "xxx"}`
**使用例:**```
"my_server"という名前で"C:/path/to/server.exe"をMCP Inspectorに登録してください
config_remove_server
删除服务器设置。
引数:
名前 · 型 · 必须 · 说明 · 例
name · string · ✅ · 服务器标识名称| "my_server"
使用例:```
"my_server"をMCP Inspectorから削除してください
#### config_list_servers
获取已注册服务器的列表。
**引数:** 无
**返回值:**```json
{
"servers": [
{
"name": "fundamental_analysis",
"transport": "stdio",
"command": "C:/path/to/fa.exe",
"args": [],
"env": {}
}
]
}
使用例:```
MCP Inspectorに登録されているサーバーの一覧を教えてください
### Phase 5: 并行处理工具
#### list_tools_batch
并行检索多台服务器的工具列表。
**引数:**
名前 · 型 · 必须 · 说明 · 例
`servers` · array · ✅ · 服务器名称数组 `["server1", "server2"]`
**使用例:**```
["fundamental_analysis", "technical_analysis"]の2つのサーバーのツール一覧を一度に取得してください
性能:
- N个服务器处理约1/N的时间
- 如果发生错误,则返回其他服务器的结果
list_resources_batch
并行检索多个服务器的资源列表。
引数:
名前 · 型 · 必须 · 说明 · 例
servers · array · ✅ · 服务器名称数组 ["server1", "server2"]
使用例:```
["fundamental_analysis", "technical_analysis"]の2つのサーバーのリソース一覧を一度に取得してください
______________________________________________________________________
## 性能特性
Phase 5中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。
### 连接滑轮
**概要:**
MCP重新使用客户端连接可加快第二次或后续连接的速度。
**性能向上:**
- 第二次以后的连接**50%以上高速化**
- 减少连接建立开销
**技术详细:**
- 透明安装(用户无需更改设置)
- 自动连接运行状况检查
- 断开连接时自动重新连接
**测定例:**```
初回接続: 150ms
2回目以降: 60ms(60%短縮)
响应高速缓存
概要:
TTL基于高速缓存的高速缓存可以快速获取经常访问的数据。
性能向上:
- 高速缓存命中时: \<1ms
- 估计高速缓存命中率: 80%以上
技术详细:
- 默认TTL: 5分钟(可设置)
- 目标:工具列表、资源列表和提示列表
- 禁用缓存:服务器重新连接时
测定例:```
キャッシュミス: 120ms
キャッシュヒット: 0.8ms(150倍高速化)
### 并列处理
**概要:**
并行对多个服务器的请求可大大缩短处理时间。
**性能向上:**
- N个服务器处理约**1/N的时间**
- 即使部分失败也会返回其他结果
**技术详细:**
- 批处理方法: `list_tools_batch`, `list_resources_batch`, `list_prompts_batch`
- 错误处理:即使部分失败也返回其他结果
- 超时:独立管理每个服务器
**测定例:**```
3サーバーを順次処理: 360ms(各120ms)
3サーバーを並列処理: 130ms(約64%短縮)
性能最佳实践
- 经常访问的数据利用高速缓存
- 因为工具一览的变化很少,所以即使反复取得也很快
- 获取多个服务器数据时使用批处理方法
list_tools_batch等活用并行处理
- 根据需要选择日志后端
- 开発环境:Memory Backend(高速)
- 本番环境:Persistent Backend(永続化)
故障排除
设定关连
Q1: 找不到设置的错误
错误消息:```
No server configuration provided. Use --server or MCP_INSPECTOR_SERVERS env var
**原因:**
`.inspector/config.json`缺少支持的问题。
**解决策:**
1. 在当前目录中`.inspector/config.json`创建
1. 按以下最小配置保存:```json
{
"servers": [
{
"name": "test_server",
"transport": "stdio",
"command": "/path/to/server"
}
],
"logging": {
"backend": "memory",
"max_logs": 10000
}
}
- Claude Desktop重新启动
Q2: 找不到服务器的错误
错误消息:```
Server not found: xxx
**原因:**
`.inspector/config.json`中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。
**解决策:**
1. `.inspector/config.json`的双曲正切值
1. `servers`确认数组中是否存在相应的服务器
1. 检查服务器名称是否拼写错误
1. AI从代理`config_list_servers`工具确认:```
MCP Inspectorに登録されているサーバーを教えてください
Q3: JSON珀斯误差
错误消息:```
Failed to parse config file: expected value at line X column Y
**原因:**
`.inspector/config.json`的,之JSON格式无效。
**解决策:**
1. 在线JSON验证数据(Jsonlin.com等)进行验证
1. 确认以下几点:
- 所有字符串均为双引号(`"`)所包围的
- 最后一个元素是逗号(`,`)是否存在
- 布莱斯(`{}`)和支架(`[]`)是否正确关闭
1. Windows在工作空间的边缘`\`的`\\`逃生
### 接続关连
#### Q4: 连接错误
**错误消息:**```
Failed to connect to server: xxx
原因:
目标服务器无法启动或命令路径无效。
解决策:
- 确认命令路径是否正确
- 直接运行目标服务器并确认其行为:```bash
Windowsの場合
C:\path\to\server.exe
macOS/Linuxの場合
/path/to/server
1. 确认环境变量是否设置正确
1. 确认是否具有执行权限(macOS/Linux):```bash
chmod +x /path/to/server
Q5: 连接超时
错误消息:```
Connection timeout after 5000ms
**原因:**
服务器启动较慢,超出默认超时5秒。
**解决策:**
`.inspector/config.json`延长超时:```json
{
"servers": [...],
"logging": {...},
"execution_config": {
"connection_timeout_ms": 15000
}
}
工具执行关系
Q6: 工具运行超时
错误消息:```json
{
"error": {
"type": "Timeout",
"tool_name": "slow_operation",
"elapsed_ms": 30500,
"configured_timeout_ms": 30000
}
}
**原因:**
工具的运行时间超过默认的30秒超时。
**解决策:**
`.inspector/config.json`延长超时:```json
{
"execution_config": {
"tool_timeout_ms": 120000
}
}
Q7: Capability警告
警告消息:```
WARN Warning: Server 'xxx' does not support tools capability, but attempting to call tool 'yyy'
**原因:**
服务器可能不支持工具功能。
**解决策:**
1. `server_inspect`在动态输入提示中单击capability确认:```
"xxx"サーバーの設定情報を取得してください
- 确认服务器是否已正确初始化
- 在服务器文档中查看支持功能
Q8: 服务器崩溃
错误消息:```json
{
"error": {
"type": "ServerCrash",
"message": "Server process terminated unexpectedly"
}
}
**原因:**
目标服务器进程崩溃。
**解决策:**
1. 检查服务器日志(`RUST_LOG=debug`),模板名称将采用不同的格式
1. 检查服务器版本(更新旧版本)
1. 确认传递给服务器的参数是否正确
1. 检查内存不足和资源限制
### 日志关系
#### Q9: 未保存日志(持续备份)
**原因:**
数据库目录不存在或没有写权限。
**解决策:**
1. 创建数据库目录:```bash
# Windowsの場合
mkdir data
# macOS/Linuxの場合
mkdir -p ./data
- 确认写入权限:```bash
macOS/Linuxの場合
chmod 755 ./data
1. `.inspector/config.json`确认路径:```json
{
"logging": {
"backend": "persistent",
"db_path": "./data/logs.db"
}
}
Q10: 无法获取日志消息
原因:
目标服务器不支持日志通知功能。
解决策:
server_inspect在动态输入提示中单击capability确认:```
"xxx"サーバーの設定情報を取得してください
1. `capabilities.logging`的`true`确认是否
1. 服务器MCP协议`notifications/message`确认是否对应
### 性能关系
#### Q11: 响应慢
**原因:**
缓存已禁用或连接池无法正常工作。
**解决策:**
1. 多次运行同一请求(高速缓存确认)
1. 查看日志:```bash
RUST_LOG=debug ./mcp_inspector_mcp
- 缓存命中日志:```
DEBUG Cache hit for tools_list on server 'xxx'
#### Q12: 内存使用量大
**原因:**
Memory Backend中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。
**解决策:**
1. `.inspector/config.json`最大日志数减少:```json
{
"logging": {
"backend": "memory",
"max_logs": 1000
}
}
- Persistent Backend切换到:```json
{
"logging": {
"backend": "persistent",
"db_path": "./data/logs.db",
"max_logs": 10000
}
}
______________________________________________________________________
## 常见问题解答
### 常见问题
#### Q1: MCP Inspector MCP是什么工具?
**A.** MCP Inspector MCP其他的MCP专用于调试和检查服务器MCP服务器。AI从代理(例如,Claude Desktop)MCP可以执行服务器工具、健康检查、日志检索等。
#### Q2: 有什么样的用例?
**A.** 主要用例如下:
- MCP服务器开发调试和测试
- 生产环境MCP服务器健康监控
- 多个MCP服务器集成管理
- 服务器capability确认和版本控制
#### Q3: Claude Desktop以外的AI客户端也可以用吗?
**A.** 好的,MCP(Model Context Protocol)对较大场景进行渲染期间已观察到该故障AI客户端可用。但是,现在主要是Claude Desktop中所述修改相应参数的值。
#### Q4: 是否建议在生产环境中使用?
**A.** 是的,是为了在生产环境中使用而设计的。以下功能在生产环境中尤其有用:
- 健康检查(响应时间、错误率测量)
- 日志消息收集(持久化)
- 错误处理(详细的错误报告)
### 技术问题
#### Q5: 支持的传输类型是什么?
**A.** 现在是**标准**中所述修改相应参数的值。将来的HTTP啊WebSocket的支持。
#### Q6: Sampling日志功能是否实际工作?
**A.** Phase 4的MonitoringTransport的规格化距离的幂函数rmcp 0.8.5的技术约束Sampling未安装通信监视。仅提供日志管理基础设施,计划在将来的版本中完全实施。
#### Q7: 高速缓存TTL可以更改吗?
**A.** 现在、TTL固定5分钟。计划在将来的版本中设置。
#### Q8: 连接池最多可以保持多少个连接?
**A.** 当前,每个服务器具有一个连接。连接数的上限设定功能将在将来追加。
### 关于设置和运用的问题
#### Q9: `.inspector/config.json`我应该把它放在哪里?
**A.** 可执行文件(`mcp_inspector_mcp.exe`或`mcp_inspector_mcp`)的目录中`.inspector`创建文件夹,并在其中`config.json`来修改标记元素的显示属性。首次启动时自动生成。
#### Q10: 环境变量和config.json的优先顺序是?
**A.** `config.json` >环境变量>按默认值排序。`config.json`的规格化距离的幂函数。
#### Q11: Memory Backend和Persistent Backend应该怎么区分使用呢?
**A.**
- **内存后端**:开发和测试环境(快速、重启时日志丢失)
- **持久后端**:生产环境(持久化,稍慢)
请在性能和持久化之间进行权衡。
#### Q12: 日志会自动删除吗?
**A.** 好的,`max_logs`中所述修改相应参数的值。默认值为10000。
### 安全问题
#### Q13: API key等机密信息应该怎么管理?
**A.** `.inspector/config.json`的,之`env`您可以将敏感信息设置为节,但建议使用环境变量管理敏感信息:```json
{
"servers": [
{
"name": "my_server",
"transport": "stdio",
"command": "/path/to/server",
"env": {
"API_KEY": "${API_KEY}"
}
}
]
}
注意: 当前未实现环境变量部署功能。包含机密信息的设定文件.gitignore中所述修改相应参数的值。
Q14: 日志是否可能包含敏感信息?
…(正文过长,页面只展示前面部分,完整内容见仓库)
