Aipolabs MCP Unified

🚀 MCP 服务器

MCP（Model Context Protocol）服务器是一种用于连接大型语言模型（LLMs）与外部工具和资源的协议。借助 Mermelad 的 MCP 服务器，能够扩展 LLM 的功能，使其可调用各类外部服务，如网络搜索、API 调用或其他工具。

🚀 快速开始

在使用 Mermelad 的 MCP 服务器前，需确保满足以下条件：

1. 已安装 Node.js 和 npm。
2. 拥有有效的 API 密钥，用于访问所选的外部服务（如网络搜索、API 等）。
3. 若计划在本机运行，建议配置 Docker 来管理环境。

✨ 主要特性

• 可连接大型语言模型与外部工具和资源。
• 支持扩展 LLM 功能，调用多种外部服务。
• 提供多种预构建的服务器，可按需选择。
• 支持自定义配置文件，灵活调整服务器行为。
• 具备内置日志记录功能，方便监控服务器状态。
• 允许扩展和自定义服务行为，满足特定需求。

📦 安装指南

全局安装

可全局安装 mermelad：

npm install -g mermelad

局部安装（推荐）

也可在项目中局部安装：

npm install mermelad

💻 使用示例

基础用法

以下是启动 MCP 服务器的示例：

# 启动一个基本的 MCP 服务器，默认监听端口 3001
mermelad start

# 或指定配置文件
mermelad start --config ./config.json

高级用法

可在 config.json 文件中定义服务器的行为：

{
  "port": 3002,
  "contextWindow": 32,
  "streaming": true,
  "services": {
    "bingSearch": {
      "apiKey": "your_bing_api_key",
      "serviceName": "Bing Search",
      "serviceEndpoint": "https://api.bing.microsoft.com/v7.0/search"
    }
  }
}

📚 详细文档

配置与集成

自定义配置文件

可在 config.json 中自定义服务器的端口、上下文窗口大小以及其他服务相关参数。

使用 Docker 运行

若使用 Docker，可这样运行：

docker run -it --rm mermelad/mermelad:latest start

常见问题解答

Q：如何获取 API 密钥？

A：可在相应的服务提供商（如 Microsoft Azure、OpenAI 等）的控制台中获取所需的 API 密钥。

Q：为什么服务器不起动？

A：请检查以下几点：

1. 确保所有依赖项已正确安装。
2. 检查配置文件是否有语法错误。
3. 查看控制台或日志文件中的错误信息，以确定具体问题。

Q：如何调整上下文窗口大小？

A：可在 config.json 中修改 contextWindow 参数来调整服务器的上下文窗口大小。

调试

若遇到问题，请检查以下内容：

1. 确保所有依赖项已正确安装。
2. 检查配置文件是否有语法错误。
3. 查看控制台或日志文件中的错误信息，以确定具体问题。
4. 若仍然无法解决问题，请在 GitHub 仓库中提交问题。

配置文件结构

Mermelad 的 MCP 服务器支持以下配置选项：

基本配置

{
  "port": 3001,
  "contextWindow": 32,
  "streaming": true
}

服务配置

可添加多个服务，每个服务都有自己的配置：

"services": {
  "service1": {
    "apiKey": "your_api_key",
    "serviceName": "Service Name",
    "serviceEndpoint": "https://api.example.com"
  },
  "service2": {
    "apiKey": "another_api_key",
    "serviceName": "Another Service",
    "serviceEndpoint": "https://another.api.com"
  }
}

完整的配置文件示例

{
  "port": 3001,
  "contextWindow": 64,
  "streaming": true,
  "services": {
    "bingSearch": {
      "apiKey": "your_bing_api_key",
      "serviceName": "Bing Search",
      "serviceEndpoint": "https://api.bing.microsoft.com/v7.0/search"
    },
    "openai": {
      "apiKey": "your_openai_api_key",
      "serviceName": "OpenAI API",
      "serviceEndpoint": "https://api.openai.com/v1/chat/completions"
    }
  }
}

集成指南

步骤 1：安装依赖

确保已安装 Node.js 和 npm。

npm install mermelad

步骤 2：创建配置文件

在项目根目录下创建 config.json 文件，并添加所需的服务配置。

步骤 3：启动服务器

使用以下命令启动 MCP 服务器：

mermelad start --config ./config.json

监控与日志

Mermelad 的 MCP 服务器提供内置的日志记录功能，可查看实时日志以监控服务器状态。

查看日志

运行时输出将显示在控制台。若需要静默模式，请使用 --silent 标志：

mermelad start --config ./config.json --silent

扩展与自定义

Mermelad 的 MCP 服务器允许扩展和自定义服务行为，以满足特定需求。

自定义逻辑

可在项目中添加自定义的处理逻辑，并通过配置文件指定相应的服务实现。

插件支持

Mermelad 支持插件系统，可开发或使用第三方插件来增强服务器的功能。