STARWARCLOUD STARWAR.AI
返回市场
布雷斯特-MCP服务器

布雷斯特-MCP服务器

作者：Nijal-AI2 星标更新：2025-08-18
安装使用来源：spider==github.com

项目介绍

Brest MCP Server

针对Brest地区的Model Context Protocol (MCP)服务器实现，提供基于MCP的交互基础设施，并内置调试和监控功能。

目录

描述

Brest MCP Server 是一个针对Brest地区的Model Context Protocol (MCP)服务器实现。它提供了强大的基础设施来管理基于MCP的交互，并包括一个用于调试和监控的MCP检查器。

该项目的目标是简化并可靠地部署和管理MCP服务。

特性

  • 🚀 MCP协议实现：完全符合Model Context Protocol标准
  • 🔍 内置检查器：通过集成的Web界面调试和监控您的MCP服务器
  • 🤖 AI代理集成：支持A2A协议和代理到代理通信
  • 🐍 基于Python：使用Python 3.12+进行现代开发实践
  • 📦 UV包管理：快速可靠的依赖管理
  • 🔧 开发工具：包含客户端工具和调试实用程序

前提条件

在安装Brest MCP Server之前，请确保您拥有以下内容：

  • Python 3.12.3 或更高版本
  • Node.js（用于MCP检查器）
  • Git（用于克隆仓库）
  • uv 包管理器（安装说明如下）

技术栈

  • 语言：Python 3.12.3或兼容版本
  • 依赖管理：uv
  • 检查器：通过Node.js的MCP检查器（npx）
  • 环境：由uv管理的虚拟环境
  • 协议：Model Context Protocol (MCP) 和 A2A（代理到代理）

安装

要本地安装和配置Brest MCP Server，请按照以下步骤操作：

  1. 安装 uv（如果尚未安装）：

    • 在Linux/macOS上： 
      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/Nijal-AI/Brest-mcp-server.git
cd Brest-mcp-server

  3. 创建并激活虚拟环境：

    uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

  4. 安装依赖项：

    uv sync

使用

运行服务器

要在本地运行服务器，请执行以下操作：

  1. 确保虚拟环境已激活：

    source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

  2. 使用MCP检查器启动服务器：

    npx @modelcontextprotocol/inspector uv run brest-mcp

  3. 在浏览器中访问MCP检查器：

    • 代理：http://localhost:3000
    • Web界面：http://localhost:5173

示例输出：

正在启动MCP检查器...
代理服务器正在3000端口监听
🔍 MCP检查器已在 http://localhost:5173 运行 🚀

使用客户端

如果您想使用Brest MCP Server与AI代理通信，可以使用提供的客户端：

uv run python tools/client.py src/server.py

AI代理集成

您还可以使用Brest MCP Server在A2A协议下与AI代理聊天。

  1. 设置代理：

    echo "MCP_TRANSPORT=stdio" > src/.env

  2. 运行代理：

    uv run agent

  3. 使用A2A样本演示（可选）：

    # 设置
git clone https://github.com/google-a2a/a2a-samples.git
echo "GOOGLE_API_KEY=your_api_key_here" > a2a-samples/demo/ui/.env

# 运行
cd a2a-samples/demo/ui
uv run main.py

    然后导航至 http://localhost:12000，进入“代理”页面并连接位于 localhost:10030 的Brest专家代理。您可以添加其他代理，然后转到主页创建新的对话以与您的代理进行讨论。

开发

对于希望贡献或开发高级特性的开发者，请遵循以下额外步骤：

  1. 确保虚拟环境已设置且依赖项已安装：

    uv venv
uv sync

  2. 使用MCP检查器调试和监控服务器：

    npx @modelcontextprotocol/inspector uv run brest-mcp

  3. 参考 pyproject.toml 文件 获取关于依赖项和配置的详细信息。

故障排除

常见问题

虚拟环境激活失败

  • 确保 uv 已正确安装并在PATH中
  • 尝试重新创建虚拟环境：uv venv --force

MCP检查器无法启动

  • 确保已安装Node.js：node --version
  • 清除npm缓存：npm cache clean --force
  • 尝试全局安装检查器：npm install -g @modelcontextprotocol/inspector

使用A2A样本时连接错误

  • 验证您的Google API密钥是否正确设置在 .env 文件中
  • 检查Brest专家代理是否在 localhost:10030 上运行
  • 确保所有必需的端口可用且未被防火墙阻止

依赖项安装失败

  • 更新 uv 到最新版本：uv self update
  • 清除缓存：uv cache clean
  • 尝试带有详细输出的安装：uv sync -v

获取帮助

如果您遇到此处未涵盖的问题：

  1. 查看GitHub上的[问题](https://github.com/Nijal-AI/Brest-m mcp-server/issues)部分
  2. 查阅MCP协议文档
  3. 创建一个新的问题，附带详细的错误消息和您的环境详情

贡献

欢迎贡献！要提出更改：

  1. 分叉仓库
  2. 创建功能分支：git checkout -b feature/your-feature-name
  3. 进行更改 并确保测试通过
  4. 遵循项目定义的编码标准
  5. 提交拉取请求 并附带清晰的更改描述

请参阅CONTRIBUTING.md文件获取详细指南。

许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。 </中文翻译>