MCP服务器检查工具

一个用于检查和测试本地MCP服务器实现的工具,支持实时交互、资源查看和协议调试。

  • by nsr-19
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nsr-19/flight-and-hotel-search-mcp-server

使用说明

概述

该项目提供了一个本地MCP服务器实现,可以使用MCP检查器工具对其进行检查和测试。检查器允许您与服务器、测试工具进行交互,查看资源,并实时调试协议实现。

先决条件

  • Python 3.13或更高版本
  • 紫外线 (推荐)或pip

安装

选项1:使用紫外线(推荐)

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv add -r requirements.txt

选项2:使用pip

# Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

运行MCP检查器

启动您的开发服务器

首先,启动MCP服务器:

python main.py

服务器应正在运行并准备接受连接。

启动MCP检查器

mcp dev main.py
访问检查器UI

检查器将在默认浏览器中自动打开。

故障排除

检查员无法连接

  • 确保 main.py 正在运行,没有错误
  • 检查服务器是否正在使用stdio传输
  • 验证没有其他进程正在使用检查器端口

工具执行失败

  • 检查Console选项卡中的错误消息
  • 验证工具参数是否与架构匹配
  • 确保安装了所需的依赖项

服务器启动时崩溃

  • 检查Python版本兼容性
  • 验证中的所有依赖关系 requirements.txt 已安装
  • 查看终端中的错误输出