AI导哈

模型连接协议服务器

Gentoro MCP Agent是一个生产就绪的MCP（模型上下文协议）服务器，用于将AI模型连接到应用程序和数据源，提供统一的HTTP端点支持OpenAI、Google Gemini和Anthropic模型，并内置知识库管理和工具集成功能。

  • by Gentoro-HQ
  • Java
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Gentoro-HQ/mcpagent

使用说明

Gentoro MCP代理

一个生产就绪的MCP（模型上下文协议）服务器，将AI模型连接到您的应用程序和数据源。它使用Spring Boot和Java 21构建，为OpenAI、Google Gemini和Anthropic模型提供了一个统一的HTTP端点，并内置了知识库管理和工具集成。

快速开始

CLI工具

在几分钟内开始使用内置的模拟环境：

# Install
curl -sSL https://raw.githubusercontent.com/Gentoro-HQ/mcpagent/main/cli/install.sh | bash

# Start chatting (auto-setup wizard launches on first run)
onemcp chat

尝试ACME分析示例：在设置过程中，我们建议您选择包含的ACME Analytics Server模式，以探索包含文档、API规范和示例查询的完整示例。

就是这样！CLI将自动执行以下操作：

  • 首次运行安装向导（选择您的AI提供商）
  • 启动所有必需的服务
  • 启动带有示例查询的交互式聊天

要求： Node.js≥20，Java≥21，Maven，Git，以及用于OpenAI/GoogleGemini/Anthopic的API密钥。

要卸载CLI，请执行以下操作： curl -sSL https://raw.githubusercontent.com/Gentoro-HQ/mcpagent/main/cli/uninstall.sh | bash

有关详细的CLI文档、所有命令和高级功能，请参阅 CLI自述文件.

使用Docker

先决条件：

  • 码头工人
  • API密钥 对于至少一个受支持的提供商：
    • OpenAI API密钥
    • Google Gemini API密钥
    • 无烟煤API键
# Pull latest image
docker pull admingentoro/gentoro:latest

# Run with OPENAI API
docker run --name mcpagent -p 8080:8080 -e OPENAI_API_KEY=your-key admingentoro/gentoro:latest

使用Docker与自定义基础文件夹

# Run within your custom foundation folder
docker run --name mcpagent -p 8080:8080 \
  -v $(pwd):/var/foundation \
  -e OPENAI_API_KEY=your-key \
  admingentoro/gentoro:latest

基础验证：代理会自动验证您的基础文件夹结构。您还可以手动验证：

# Validate foundation before running
docker run --rm \
  -v $(pwd):/var/foundation \
  -e APP_ARGS="--process=validate" \
  admingentoro/gentoro:latest

如果验证失败，请检查容器日志以获取特定的错误消息和指导。

MCP检查员

使用MCP检查器与您的代理进行交互：

# Launch the MCP Inspector
npx @modelcontextprotocol/inspector@latest --port 3001 --open

当检查器打开时：

  1. MCP URL应设置为 http://localhost:8080/mcp
  2. 根据您的偏好和要求调整配置
  3. 点击“连接”

注： 在连接MCP检查器之前，等待30-60秒让服务器完全初始化。

容器管理

使用命名容器，您可以轻松管理MCP代理：

# Start/stop the container
docker start mcpagent
docker stop mcpagent

# View logs
docker logs mcpagent

# Access container shell
docker exec -it mcpagent bash

# Remove container when done
docker rm mcpagent

故障排除

缓慢启动（30-60秒）

默认配置使用AI提示生成，这可能很慢。为了更快地启动：

# Disable AI hint generation
docker run --name mcpagent -p 8080:8080 \
  -e OPENAI_API_KEY=your-key \
  -e KNOWLEDGE_BASE_HINT_USE_AI=false \
  admingentoro/gentoro:latest

MCP检查器连接问题

如果MCP检查器显示“插座挂起”错误：

  1. 等待30-60秒，让服务器完全初始化
  2. 确保MCP URL设置为 http://localhost:8080/mcp
  3. 尝试在MCP检查器中刷新连接

TypeScript运行时问题

如果你看到TypeScript运行时错误，优化版本包括修复：

  • 正确的启动顺序（TypeScript运行时先启动）
  • 健康检查端点
  • 失败连接的重试逻辑

相关 MCP