使用说明

项目简介

本项目提供了一系列 API 模板,旨在扩展 Databutton 托管的 MCP 服务器的功能。通过集成这些模板,您可以快速为 AI Agent 添加诸如网页搜索、用户记忆存储等实用工具,从而提升其能力和应用场景。

主要功能点

  • DuckDuckGo 网页搜索: 集成免费的 DuckDuckGo 搜索引擎,使 AI Agent 具备即时访问互联网信息的能力,无需 API 密钥。
  • 用户记忆存储: 允许 AI Agent 存储和检索用户的偏好、习惯、目标等关键信息,从而实现更个性化和持续性的交互体验。数据存储在 Databutton 内置存储中,无需额外配置数据库。

安装步骤

  1. 创建 Databutton 应用: 首先,您需要在 Databutton 平台上创建一个新的 API 应用项目。
  2. 复制 API 模板: 从本仓库的 'API Templates' 文件夹中,选择您需要的 API 模板(例如 'duckduckgo_search.py' 或 'read_and_store_memories.py')。
  3. 粘贴代码到应用: 将选定的模板代码完整复制粘贴到您的 Databutton API 应用的代码编辑器中,替换默认的代码。
  4. 部署 Databutton 应用: 在 Databutton 平台中,点击部署按钮,将您的应用部署上线。部署成功后,您将获得一个 Databutton 应用的 URL。

服务器配置

MCP 客户端需要配置连接到部署在 Databutton 上的 MCP 服务器。以下是一个示例配置,请根据您的 Databutton 应用信息进行修改:

{
    "server name": "Databutton MCP Server",
    "baseUrl": "your-databutton-app-url",  // 请将 "your-databutton-app-url" 替换为您的 Databutton 应用 URL (例如:https://your-app-name.databutton.app)
    "description": "此配置用于连接部署在 Databutton 上的 MCP 服务器。MCP 客户端需要配置此 baseUrl 以访问服务器提供的 API 工具。",
    "tools": [  // 可用工具端点示例 (请根据您集成的 API 模板进行调整)
        {"name": "DuckDuckGo Search", "endpoint": "/search"},
        {"name": "Memory Storage", "endpoint": "/store-memory"}
    ]
}

配置参数说明:

  • 'server name': MCP 服务器的名称,您可以自定义。
  • 'baseUrl': 必需配置。这是您的 Databutton 应用的 URL,MCP 客户端将通过此 URL 连接到服务器。请务必替换为您的实际应用 URL。
  • 'description': 服务器的描述信息,可选。
  • 'tools': 重要配置。这是一个 JSON 数组,列出了服务器提供的工具。
    • 'name': 工具的名称,用于在 MCP 客户端中识别工具。
    • 'endpoint': 工具的 API 端点路径,相对于 'baseUrl'。请根据您在 Databutton 应用中集成的 API 模板,配置正确的端点。例如,如果您使用了 'duckduckgo_search.py' 模板,则应配置 '/search' 端点。

请注意: 上述 'tools' 配置仅为示例,您需要根据您实际集成的 API 模板,添加或修改 'tools' 数组,确保与您的 Databutton 应用提供的 API 端点一致。

基本使用方法

  1. 确保您的 Databutton 应用已成功部署并获取了应用 URL。
  2. 在 MCP 客户端中,根据上述 “服务器配置” 示例,填写正确的 'baseUrl' 和 'tools' 信息。
  3. 启动 MCP 客户端,客户端将根据配置连接到您的 Databutton MCP 服务器。
  4. AI Agent 即可通过 MCP 协议调用您在 Databutton 应用中集成的 API 工具,例如使用网页搜索工具查询信息,或使用记忆存储工具记录用户偏好。

请参考每个 API 模板的代码和文档,了解更详细的 API 使用方法、请求参数和响应格式。

信息

分类

网页与API