MCP服务器通用版
在SillyTavern中管理并自动注册模型上下文协议（MCP）服务器。启动/停止服务器，启用或禁用其工具，并直接从粘贴的JSON片段批量导入新的服务器定义。
______________________________________________________________________
⚠️ 警告
MCP服务器可以执行任意命令并访问您的系统资源。在不了解MCP服务器功能的情况下使用它们可能会非常危险。在添加服务器之前，请务必审查其配置。使用前请自行承担风险。
______________________________________________________________________
特点/特性
- 带有实时状态（运行中/已停止）的服务器列表
- 每个服务器的启动、停止、重新加载工具按钮
- 启用/禁用服务器（复选框）
- 按服务器查看并切换单个工具
- MCP工具作为函数调用工具的自动注册
mcp____） - 从原始代码片段中添加单个服务器
- 批量一次性导入多台服务器
- 就地编辑服务器配置JSON文件
- 删除服务器条目
- 更改后自动刷新工具缓存
______________________________________________________________________
安装
- 在SillyTavern中打开 扩展（或插件） 面板。
- 使用 从Git安装 并提供存储库URL：
https://github.com/Inversity/SillyTavern-MCP-Servers-Universal- 如果面板未自动出现，请重新加载/重启SillyTavern。
- 寻找标题为的抽屉 MCP服务器通用版.
______________________________________________________________________
快速入门
- 打开 MCP服务器通用版 面板。
- 点击 添加服务器 然后粘贴一个配置片段（示例见下文），接着按下 添加。
- 确保服务器的复选框处于开启（启用）状态。如果未运行，请点击 开始.
- 点击 工具 按钮用于启用/禁用特定工具（保存以应用）。
- 使用一个具备工具调用功能的模型（如OpenAI/Claude等）并启用函数调用，来启动一个生成过程；工具将显示在
/tools-list.
______________________________________________________________________
接受的代码片段格式
你可以将以下任意一项粘贴到 添加服务器 弹出窗口：
1. 命名键 + 对象
"OpenMemory": {
"type": "stdio",
"command": "npx",
"args": ["-y", "openmemory"],
"env": {"OPENMEMORY_API_KEY": "sk_your_key", "CLIENT_NAME": "openmemory"}
}2. 裸对象（提供名称字段或填写名称输入框）
{
"type": "http",
"url": "https://mcp.deepwiki.com/sse"
}如果未嵌入，请在单独的输入框中提供名称。
3. 多重导入（导入按钮）
"playwright": {"type": "stdio", "command": "npx", "args": ["@playwright/mcp@latest", "--browser=chromium", "--headless"]},
"filesystem": {"type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "%ST%", "%APPDATA%/Code - Insiders"]}或者把它们包起来：
{
"playwright": {"type": "stdio", "command": "npx", "args": ["@playwright/mcp@latest"]},
"deepwiki": {"type": "http", "url": "https://mcp.deepwiki.com/sse"}
}______________________________________________________________________
编辑服务器
- 点击 编辑 紧挨着一台服务器。
- 修改JSON（必须保持有效）。
- 保存以覆盖已存储的配置。
删除服务器
点击 德尔 → 确认。来自该服务器的工具将自动注销。
______________________________________________________________________
工具注册详情
- 命名模式：
mcp____（非字母数字字符被替换为_）。 - 参数模式直接来自MCP工具所宣传的输入模式（如果缺失，则默认为空对象）。
- 动作：呼叫
/api/plugins/mcp/servers//call-tool哪个代理连接到MCP服务器。 - 显示名称：
:.
如果服务器或工具在重新加载时被禁用/移除，相关工具将自动注销。
______________________________________________________________________
验证逻辑
type默认为stdio如果省略且没有url提供；变成http如果url存在。- 对于
stdio:command所需的。 - 对于
http/sse：url需要。 - 导入时会静默地覆盖同名的现有服务器（删除 + 重新创建）。
______________________________________________________________________
故障排除
| 症状 | 解决方案 |
|---|---|
| 服务器显示 *停止* 添加后 | 点击 开始确保命令/路径在环境中可访问。 |
工具未显示在 /tools-list | 压力 重新加载工具 或者确保函数调用+工具模型处于激活状态。 |
| 工具调用失败 | 检查服务器日志/手动运行命令；验证环境变量。 |
| 进口表示 *没有有效的服务器块* 确保粘贴的文本是有效的JSON片段；请参阅格式部分。 |
______________________________________________________________________
安全注意事项
- 在配置文件中输入的环境变量会存储在MCP设置文件中。请避免将机密信息提交到版本控制系统中。尽可能优先使用外部注入的环境变量进行引用。
- 旋转钥匙？编辑服务器 → 更新环境 → 保存 → 重启服务器。
______________________________________________________________________
版本控制
| 版本 | 备注 |
|---|---|
| 0.2.0 | 通用命名、批量导入、编辑/删除、增强验证功能 |
| 0.1.0 | 初始实现 |
______________________________________________________________________
路线图/想法
- 模式驱动的表单构建器（使用字段而非原始JSON）
- 将选定的服务器导出为代码片段
- 每种工具的使用指标
- 组操作（启动/停止所有）
______________________________________________________________________
许可证
MIT 许可证 – 请参阅 许可证。
______________________________________________________________________
贡献；做出贡献
- 为仓库创建分支
- 创建一个特性分支：
git checkout -b feat/your-feature - 提交更改 + 适用时进行测试
- 打开一个包含理由说明和截图的拉取请求（PR）
______________________________________________________________________
致谢
为SillyTavern生态系统打造 Inversity（注：该词并非一个广泛认知的英文单词，可能是特定语境或品牌名，因此直接音译）受新兴的模型上下文协议规范的启发。