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 支持插件系統，可開發或使用第三方插件來增強服務器的功能。