搜索模型上下文协议服务

Search MCP Server 是一个基于模型上下文协议(MCP)的服务,通过 Coze API 提供网页搜索功能。它具有可配置的搜索结果数量和分页功能,自动清理搜索查询中的特殊字符,并内置了API测试工具。该服务采用TypeScript实现,具有完整的类型安全,并通过环境变量进行安全的令牌管理。

  • by YouXam
  • 更新于
在 GitHub 查看 YouXam/search-mcp

使用说明

基本能力

产品定位

Search MCP Server 是一个提供网页搜索功能的模型上下文协议服务。

核心功能

  • 通过 Coze API 工作流进行网页搜索
  • 可配置的搜索结果数量和分页
  • 自动清理搜索查询中的特殊字符
  • 内置 API 测试工具
  • 使用 TypeScript 实现,具有完整的类型安全
  • 通过环境变量进行安全的令牌管理

适用场景

  • 需要集成网页搜索功能的应用程序
  • 开发者需要测试和调试 Coze API 搜索功能
  • 需要安全管理和配置搜索参数的环境

工具列表

  1. web_search:搜索网页信息。
    • 参数:query(必需,搜索内容)、num(可选,结果数量,默认5)、start(可选,分页偏移量,默认0)
  2. test_search_api:测试 Coze API 连接和响应结构。
    • 参数:query(可选,测试查询,默认"ai")

使用教程

使用依赖

  1. 安装 pnpm(如果尚未安装)

安装教程

  1. 使用 pnpm 安装依赖:
pnpm install
  1. 设置环境变量:
cp .env.example .env
# 编辑 .env 文件并添加您的 COZE_TOKEN
  1. 构建服务器:
pnpm run build

调试方式

  1. 运行服务器:
# 开发模式
pnpm run dev

# 生产模式
pnpm run start
  1. 使用内置测试工具验证 API 配置:
    • 启动服务器
    • 通过 MCP 客户端使用 test_search_api 工具
    • 检查响应结构并根据需要调整格式
  2. 调试模式(启用调试日志):
DEBUG=1 pnpm run dev