Brest MCP 服务器

为布雷斯特地区提供 MCP (模型上下文协议) 服务。

预requis

• Python: 3.12.3 或兼容版本
• uv: 依赖管理工具 (安装)
• Node.js: 用于通过 npx 运行 MCP 检查器

快速开始

1. 安装 uv (如果需要):

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

Windows 版本

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 克隆并启动服务器:

   git clone https://github.com/BSE-dev/Brest-mcp-server.git
   cd Brest-mcp-server/brest-mcp
   uv venv
   source .venv/bin/activate  # Windows: .venv\Scripts\activate
   uv sync
   npx @modelcontextprotocol/inspector uv run brest-mcp
   

3. 验证: 打开 http://localhost:5173 以访问 MCP 检查器。

步骤详情

1. 克隆仓库

git clone https://github.com/BSE-dev/Brest-mcp-server.git

cd Brest-mcp-server/brest-mcp

2. 创建并激活环境

uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

3. 安装依赖

uv sync

4. 启动服务器

npx @modelcontextprotocol/inspector uv run brest-mcp

• 代理在 port 3000 上。
• Web 界面: http://localhost:5173。

输出示例:

Starting MCP inspector...
Proxy server listening on port 3000
🔍 MCP Inspector is up and running at http://localhost:5173 🚀

问题解决

• 错误 ECONNREFUSED 127.0.0.1:3001: 检查 brest-mcp 是否在 3001 端口 (SSE) 上监听。 确保它已启动并且端口空闲。
• 依赖损坏: 删除 .venv 和 uv.lock，然后重新运行 uv venv 和 uv sync。

注意

• 在启动服务器之前激活环境以使用正确的依赖项。
• 查看 pyproject.toml 以获取特定依赖项。