关键词

SLOP适配器MCP桥接协议转换AI工具集成后端服务连接

项目简介

本项目 'mcp-slop-adapter' 是一个轻量级的适配器，旨在连接 MCP (Model Context Protocol) 客户端（例如 Claude Desktop）与任何兼容 SLOP (Simple Language Open Protocol) 的服务器。它充当桥梁，使得 MCP 客户端能够利用 SLOP 服务器提供的工具和资源。

主要功能点

  • MCP 协议适配: 将 MCP 客户端的请求转换为 SLOP 服务器能够理解的 API 调用。
  • SLOP 资源暴露: 把 SLOP 服务器提供的资源转换为 MCP 资源，供 MCP 客户端访问。
  • SLOP 功能扩展: 为 SLOP 特定的功能端点（如 chat, memory, pay）提供 MCP 工具，扩展 MCP 客户端的能力。
  • 错误处理: 处理 MCP 和 SLOP 协议之间的错误转换，确保通信的稳定性。

安装步骤

  1. 确保 Node.js 环境: 请确保您的系统中已安装 Node.js 和 npm (或 yarn)。
  2. 全局安装 (可选): 如果您希望全局安装 'mcp-slop-adapter'，可以运行以下命令： 
    npm install -g @kortexa-ai/mcp-slop-adapter
  3. 使用 npx (推荐): 您也可以直接使用 'npx' 运行适配器，无需全局安装： 
    npx @kortexa-ai/mcp-slop-adapter http://your-slop-server-url

服务器配置 (MCP 客户端 - Claude Desktop)

要将 Claude Desktop 连接到 SLOP 服务器，您需要编辑 Claude Desktop 的配置文件。根据您的操作系统，配置文件路径如下：

  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'
  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

在配置文件中，添加或修改 'mcpServers' 部分，加入以下配置信息：

{
    "mcpServers": {
        "mcp-slop-adapter": {  // 服务器名称，您可以自定义
            "command": "npx",  // 启动服务器的命令，这里使用 npx
            "args": [
                "@kortexa-ai/mcp-slop-adapter",  // 要执行的 npm 包名
                "http://your-slop-server-url"   // SLOP 服务器的 URL 地址，**请替换为您的 SLOP 服务器地址**
            ]
        }
    }
}

配置参数说明:

  • 'server name': 'mcp-slop-adapter' (您可以自定义服务器名称，用于在 Claude Desktop 配置中标识此连接)
  • 'command': 'npx' (指定用于启动服务器的命令，这里使用 'npx' 来运行 npm 包)
  • 'args': 启动命令的参数列表
    • '"@kortexa-ai/mcp-slop-adapter"': 指定要运行的 npm 包名称，即 'mcp-slop-adapter'
    • '"http://your-slop-server-url"': 请务必替换为您的实际 SLOP 服务器地址。这是 'mcp-slop-adapter' 连接的后端 SLOP 服务器的 URL。

基本使用方法

  1. 启动 SLOP 服务器: 首先确保您的 SLOP 服务器正在运行，并可通过您配置的 URL 访问。
  2. 启动 MCP-SLOP 适配器: 根据您的安装方式，使用 'npx' 或全局安装的方式启动 'mcp-slop-adapter'，并传入您的 SLOP 服务器地址作为参数。例如： 
    npx @kortexa-ai/mcp-slop-adapter http://your-slop-server-url
  3. 配置 Claude Desktop: 按照上述 "服务器配置" 步骤，编辑 Claude Desktop 的配置文件，并确保配置中的 SLOP 服务器地址正确。
  4. 连接 Claude Desktop: 启动或重启 Claude Desktop。Claude Desktop 将会通过 'mcp-slop-adapter' 连接到您的 SLOP 服务器，您就可以在 Claude Desktop 中使用 SLOP 服务器提供的工具和资源了。

现在，您的 Claude Desktop 应该能够通过 'mcp-slop-adapter' 与 SLOP 服务器进行交互，从而利用 SLOP 服务器的功能。

信息

分类

开发者工具

访问项目