使用指南
🤔 是什么?
一个基于 Tampermonkey/ScriptCat 的浏览器脚本,能帮您增强 DeepSeek 聊天机器人的功能。简单来说,目前功能它让 DeepSeek 能够调用本地工具,比如执行命令、操作文件、进行网络搜索等。
✨ 它能做什么?
- 实时监控 DeepSeek 聊天的 SSE (Server-Sent Events)
- 通过 MCP 协议调用本地工具
- 支持自动发送工具调用结果
- 管理各种本地工具调用
- 拓展更多的工具
🎯 核心特性
- ✅ 无损 Unicode 提取:保留所有字符的原始编码
- ✅ 优化 SSE 处理:确保多字节字符完整
- ✅ 正则匹配优化:支持中文的正则匹配
- ✅ 灵活配置:支持多种配置项
📋 系统要求
要使用这个工具,您需要准备以下环境:
- 浏览器:Chrome、Microsoft Edge、Firefox 等支持 Tampermonkey/ScriptCat 的浏览器
- 脚本管理器:Tampermonkey 或 ScriptCat 扩展
- Node.js:v16+(用于运行 MCP 服务)
- Python:3.8+(用于运行 FastMCP Shell 服务)
- npm:最新版本
🚀 安装步骤
1. 安装 MCP 服务器依赖
首先,让我们安装必要的依赖包:
# 安装 Python 依赖
pip install -r mcp/fastmcp-shell/requirements.txt
2. 安装 Bing CN MCP
接下来,安装 Bing 搜索服务:
# 进入 Bing CN MCP 目录
cd mcp/bing-cn-mcp
# 安装 Bing CN MCP 包
npm install bing-cn-mcp
3. 安装浏览器脚本
现在,安装浏览器脚本:
- 打开 Tampermonkey 或 ScriptCat 扩展
- 点击「添加新脚本」
- 复制
js.js 的内容到编辑器
- 点击「文件」→「保存」
- 访问
https://chat.deepseek.com/,脚本会自动运行
⚙️ 配置说明
MCP 代理配置 (mcp.json)
MCP 代理服务器使用 mcp.json 进行配置,主要配置项如下:
{
"server": {
"title": "可配置MCP代理",
"description": "接收HTTP请求,根据配置文件转发给对应的MCP服务",
"version": "1.0.0",
"host": "0.0.0.0",
"port": 8024
},
"services": {
"bing_search": {
"description": "Bing搜索服务",
"command": "node",
"args": ["mcp/bing-cn-mcp/node_modules/bing-cn-mcp/build/index.js"],
"tools": ["bing_search", "crawl_webpage"],
"auto_start": true
},
"local_shell": {
"description": "万能工具管道",
"command": "python",
"args": ["mcp/fastmcp-shell/windows_compatible_universal_pipe_v2.py"],
"tools": ["execute_command", "read_file", "write_file", "list_directory", "get_cwd", "get_system_info", "universal_tool", "get_role_card"],
"auto_start": true
}
}
}
服务器配置
| 配置项 |
说明 |
默认值 |
| host |
服务器监听地址 |
0.0.0.0 |
| port |
服务器监听端口 |
8024 |
| title |
服务器标题 |
可配置MCP代理 |
| description |
服务器描述 |
接收HTTP请求,根据配置文件转发给对应的MCP服务 |
| version |
服务器版本 |
1.0.0 |
服务配置
每个服务配置包含以下字段:
| 配置项 |
说明 |
示例值 |
| description |
服务描述 |
Bing搜索服务 |
| command |
启动命令 |
node |
| args |
命令参数 |
["mcp/bing-cn-mcp/node_modules/bing-cn-mcp/build/index.js"] |
| tools |
提供的工具列表 |
["bing_search", "crawl_webpage"] |
| auto_start |
是否自动启动 |
true |
客户端脚本配置 (js.js)
客户端脚本包含以下可配置项:
全局变量
// 自动发送开关
window.shouldSendAfterStream = false;
// 工具执行结果存储
window.commandResults = '';
// UI 中显示的占位符
window.MCP_SEND_PLACEHOLDER = '发送命令xxxoooxxx';
工具调用地址
// MCP 服务器地址
const client = new UniversalMCPClient('http://localhost:8024/mcp');
角色卡配置
角色卡存储在 mcp/fastmcp-shell/role_card.txt 文件中,包含 MCP 专家的角色定义、工具清单、格式要求等。
🚀 如何使用?
1. 启动 MCP 服务器
首先,启动 MCP 代理服务器:
# 进入项目根目录
# 启动 MCP 代理服务器
python servers.py
服务器启动成功后,你将看到以下输出:
==================================================
🚀 可配置MCP代理服务器启动
🌐 地址: http://localhost:8024
📝 用法: POST http://localhost:8024/mcp
==================================================
🔧 初始化服务...
✅ 服务 bing_search 启动成功
✅ 服务 local_shell 启动成功
INFO: Started server process [12345]
INFO: Uvicorn running on http://0.0.0.0:8024 (Press CTRL+C to quit)
## 🛠️ 工具清单
### 基础工具
| 工具名 | 功能 | 可靠性 |
|-------|------|--------|
| execute_command | 执行 shell 命令 | ⭐⭐⭐⭐⭐ |
| get_cwd | 获取当前工作目录 | ⭐⭐⭐⭐⭐ |
| list_directory | 列出目录内容 | ⭐⭐⭐⭐⭐ |
| read_file | 读取文件内容 | ⭐⭐⭐⭐⭐ |
| write_file | 写入文件内容 | ⭐⭐⭐⭐☆ |
### 高级工具
| 工具名 | 功能 | 可靠性 |
|-------|------|--------|
| bing_search | Bing 网络搜索,支持自定义结果数量和翻页 | ⭐⭐⭐⭐⭐ |
- `query` (必填): 搜索关键词,例如 "人工智能"
- `count` (可选): 返回多少条结果,默认 10 条,最多 50 条
- `offset` (可选): 从第几条结果开始,用于翻页,默认 0
| crawl_webpage | 网页内容抓取 | ⭐⭐⭐⭐☆ |
| get_system_info | 获取系统信息 | ⭐⭐⭐⭐⭐ |
| universal_tool | 万能工具 | ⭐⭐⭐⭐☆ |
### 自定义工具 管理多个MCP 运行,可以代替其他工具。
你可以通过修改 `mcp.json` 添加新的服务和工具:
```json
{
"services": {
"custom_service": {
"description": "自定义服务",
"command": "node",
"args": ["custom_service.js"],
"tools": ["custom_tool1", "custom_tool2"],
"auto_start": false
}
}
}