使用说明
基本能力
产品定位
Search MCP Server 是一个提供网页搜索功能的模型上下文协议服务。
核心功能
- 通过 Coze API 工作流进行网页搜索
- 可配置的搜索结果数量和分页
- 自动清理搜索查询中的特殊字符
- 内置 API 测试工具
- 使用 TypeScript 实现,具有完整的类型安全
- 通过环境变量进行安全的令牌管理
适用场景
- 需要集成网页搜索功能的应用程序
- 开发者需要测试和调试 Coze API 搜索功能
- 需要安全管理和配置搜索参数的环境
工具列表
- web_search:搜索网页信息。
- 参数:
query(必需,搜索内容)、num(可选,结果数量,默认5)、start(可选,分页偏移量,默认0)
- 参数:
- test_search_api:测试 Coze API 连接和响应结构。
- 参数:
query(可选,测试查询,默认"ai")
- 参数:
使用教程
使用依赖
- 安装 pnpm(如果尚未安装)
安装教程
- 使用 pnpm 安装依赖:
pnpm install
- 设置环境变量:
cp .env.example .env
# 编辑 .env 文件并添加您的 COZE_TOKEN
- 构建服务器:
pnpm run build
调试方式
- 运行服务器:
# 开发模式
pnpm run dev
# 生产模式
pnpm run start
- 使用内置测试工具验证 API 配置:
- 启动服务器
- 通过 MCP 客户端使用
test_search_api工具 - 检查响应结构并根据需要调整格式
- 调试模式(启用调试日志):
DEBUG=1 pnpm run dev