使用说明
项目简介
本项目提供了一系列 API 模板,旨在扩展 Databutton 托管的 MCP 服务器的功能。通过集成这些模板,您可以快速为 AI Agent 添加诸如网页搜索、用户记忆存储等实用工具,从而提升其能力和应用场景。
主要功能点
- DuckDuckGo 网页搜索: 集成免费的 DuckDuckGo 搜索引擎,使 AI Agent 具备即时访问互联网信息的能力,无需 API 密钥。
- 用户记忆存储: 允许 AI Agent 存储和检索用户的偏好、习惯、目标等关键信息,从而实现更个性化和持续性的交互体验。数据存储在 Databutton 内置存储中,无需额外配置数据库。
安装步骤
- 创建 Databutton 应用: 首先,您需要在 Databutton 平台上创建一个新的 API 应用项目。
- 复制 API 模板: 从本仓库的 'API Templates' 文件夹中,选择您需要的 API 模板(例如 'duckduckgo_search.py' 或 'read_and_store_memories.py')。
- 粘贴代码到应用: 将选定的模板代码完整复制粘贴到您的 Databutton API 应用的代码编辑器中,替换默认的代码。
- 部署 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 端点一致。
基本使用方法
- 确保您的 Databutton 应用已成功部署并获取了应用 URL。
- 在 MCP 客户端中,根据上述 “服务器配置” 示例,填写正确的 'baseUrl' 和 'tools' 信息。
- 启动 MCP 客户端,客户端将根据配置连接到您的 Databutton MCP 服务器。
- AI Agent 即可通过 MCP 协议调用您在 Databutton 应用中集成的 API 工具,例如使用网页搜索工具查询信息,或使用记忆存储工具记录用户偏好。
请参考每个 API 模板的代码和文档,了解更详细的 API 使用方法、请求参数和响应格式。
信息
分类
网页与API