项目简介

TypingMind MCP Connector 是一个便捷的桥梁，旨在简化 TypingMind 与各种 MCP 服务器的集成过程。它作为一个中央服务器运行，可以启动、管理和监控多个独立的 MCP 客户端进程。通过提供 RESTful API，TypingMind 等 MCP 客户端应用可以轻松地与这些 MCP 客户端进行交互，从而利用它们提供的资源、工具和 Prompt 模板，扩展 AI 应用的功能。

请注意，此项目本身并非直接实现 MCP 协议的服务器，而是一个 MCP 客户端管理器。它通过启动和管理 MCP 客户端进程，并通过 REST API 提供管理和控制这些客户端的能力。因此，你需要有实际的 MCP 服务器程序（例如，你自己的模型或工具的 MCP 实现），然后通过此 Connector 进行管理和连接到 TypingMind。

主要功能点

MCP 客户端管理: 集中管理多个 MCP 客户端进程的启动、停止、重启和状态监控。
工具调用: 通过 REST API 允许 TypingMind 等客户端调用由托管的 MCP 客户端提供的工具。
健康检查: 提供 '/ping' 端点进行健康状态检查。
REST API 接口: 提供清晰的 RESTful API，方便集成和控制 MCP 客户端。
身份验证: 使用 Bearer Token 进行 API 请求身份验证，保障安全性。
端口自动分配: 自动查找可用端口，避免端口冲突。

安装步骤

安装 Node.js: 确保你的系统中安装了 Node.js (版本 14 或更高)。
运行 MCP Connector: 无需安装，使用 'npx' 命令即可快速启动：
```
npx @typingmind/mcp <auth-token>
```
将 '<auth-token>' 替换为你从 TypingMind 获取的身份验证令牌。
保持运行: 启动 MCP Connector 的终端窗口需要保持打开状态，以便 TypingMind 可以连接。

服务器配置

TypingMind MCP Connector 本身作为 MCP 客户端的管理器，并不直接需要配置启动命令和参数来连接“MCP服务器”。 你需要配置的是你想管理的 MCP 客户端的信息。 在 TypingMind 的 MCP 集成页面，你需要配置 MCP Connector 服务器的地址 (例如 'http://localhost:50880') 和你在启动 Connector 时使用的 身份验证令牌。

Connector 自身会监听 '50880'–'50889' 范围内的可用端口，并提供 REST API 服务。

要让 TypingMind 使用你的 MCP 功能，你需要在 TypingMind 中配置连接到 TypingMind MCP Connector，而不是直接配置 MCP 服务器。然后通过 Connector 的 '/start' 接口来管理和启动你的 MCP 客户端进程。

'/start' 接口 (POST) 接收一个 JSON 对象，用于配置需要启动和管理的 MCP 客户端。例如，你可以发送如下 JSON 数据到 '/start' 接口来启动一个或多个 MCP 客户端：

{
  "mcpServers": {
    "client1": {
      "command": "/path/to/your/mcp-client-program",
      "args": ["--model", "your-model-name"],
      "env": {
        "API_KEY": "your_api_key"
      }
    },
    "client2": {
      "command": "python",
      "args": ["/path/to/another/mcp_client.py", "--port", "8080"]
    }
  }
}

配置参数说明:

'mcpServers': 一个 JSON 对象，键为自定义的客户端 ID（例如 'client1', 'client2'），值为客户端的配置信息。
'command': [必填] MCP 客户端程序的可执行文件路径或命令。例如，可以是 Python 脚本、Node.js 程序或其他可执行程序。
'args': [可选] 传递给 MCP 客户端程序的命令行参数，以字符串数组形式提供。例如，模型名称、端口号等。
'env': [可选] 设置 MCP 客户端程序运行时的环境变量，以 JSON 对象形式提供。例如，API 密钥等。

重要提示: 你需要根据你的 MCP 客户端程序的实际情况，配置正确的 'command'、'args' 和 'env'。 TypingMind MCP Connector 仅负责启动和管理这些客户端进程，并提供 REST API 接口供 TypingMind 调用工具。

基本使用方法

启动 TypingMind MCP Connector: 在终端运行 'npx @typingmind/mcp <auth-token>'，并保持运行。
配置 TypingMind: 在 TypingMind 的 MCP 集成页面，填写 MCP Connector 服务器地址（例如 'http://localhost:端口号'，端口号通常为 '50880' 或自动分配的端口）和身份验证令牌。
配置 MCP 客户端: 使用 POST 请求访问 MCP Connector 的 '/start' 接口 (例如，使用 curl, Postman 或 TypingMind 的界面)，发送包含 MCP 客户端配置信息的 JSON 数据，启动和管理你的 MCP 客户端。
在 TypingMind 中使用: 配置完成后，TypingMind 即可通过 MCP Connector 调用你配置的 MCP 客户端提供的工具和功能。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息