MCP 服务器概述

概述

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

先决条件

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

1. 您已经安装了 Node.js 和 npm。
2. 您需要一个有效的 API 密钥来访问您选择的外部服务（如网络搜索、API 等）。
3. 如果您计划使用本机运行，建议配置 Docker 来管理环境。

安装

全局安装

您可以全局安装 mermelad：

npm install -g mermelad

局部安装（推荐）

或者在项目中局部安装：

npm install mermelad

使用

Mermelad 提供了多种预构建的 MCP 服务器，您可以根据需求选择使用。

示例：启动一个简单的 MCP 服务器

以下是一个启动 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 仓库中提交问题。

MCP 服务器配置

配置文件结构

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 支持插件系统，您可以开发或使用第三方插件来增强服务器的功能。