MCP Connector

MCP Connector

MCP Connector 是一款轻量级服务，可运行和管理多个模型上下文协议（MCP）服务，专为与 TypingMind 集成而设计。它提供了一种简单的方式，可在本地计算机或远程服务上运行 MCP 服务，让你通过简单的 REST API 将自定义 AI 模型或工具连接到 TypingMind。

---

如何在本地设备上运行

你可以使用 npx 快速启动 MCP Connector（无需安装）：

npx @typingmind/mcp <auth-token>

• 将 <auth-token> 替换为 TypingMind 提供的身份验证令牌。

使用 TypingMind 时，请保持此终端窗口打开。

HTTPS 支持

要启用 HTTPS，请设置以下环境变量：

CERTFILE=./path/to/certificate.crt KEYFILE=./path/to/privatekey.key npx @typingmind/mcp <auth-token>

• CERTFILE：SSL 证书文件的路径
• KEYFILE：SSL 私钥文件的路径

设置这两个变量后，服务将使用 HTTPS 而非 HTTP。

---

如何在服务上运行

如果你更希望在远程服务上运行 MCP Connector：

1. 安装 Node.js（版本 14 或更高版本）。

2. 使用 npx 运行服务：

   npx @typingmind/mcp <auth-token>
   

   要使用 HTTPS 运行：

   CERTFILE=./path/to/certificate.crt KEYFILE=./path/to/privatekey.key npx @typingmind/mcp <auth-token>
   

   另外，如需持续运行（例如，关闭 SSH 后仍继续运行），可以使用 pm2 或 screen/tmux 等进程管理器：

   pm2 start npx -- @typingmind/mcp <auth-token>
   

---

如何连接到 TypingMind

要将 MCP Connector 连接到 TypingMind：

1. 按照 www.typingmind.com/mcp 中的说明操作。
2. 在 TypingMind MCP 集成页面中，粘贴 MCP Connector 服务地址（http://localhost:<port> 或你的服务 IP 地址和端口）以及身份验证令牌。

---

REST API 端点

所有 API 端点都需要通过启动服务时提供的 Bearer 令牌进行身份验证。

端点	方法	说明
/ping	GET	健康检查；返回 { status: "ok" }
/start	POST	启动一个或多个 MCP 客户端；请求正文：{ mcpServers: { ... } }
/restart/:id	POST	重启指定客户端
/clients	GET	列出所有正在运行的 MCP 客户端及其工具
/clients/:id	GET	获取指定客户端的信息
/clients/:id/tools	GET	列出客户端可用的工具
/clients/:id/call_tools	POST	调用客户端的工具；请求正文：{ name, arguments }
/clients/:id	DELETE	停止并删除客户端

注意：

• 所有请求都需要包含 Authorization: Bearer <auth-token> 标头。
• 可用端口：服务将选择端口 50880 或 50881，请确保系统中这些端口可用。你也可以使用 PORT 环境变量指定其他端口。

---

许可证

MIT