MCP书签管理器示例
这是一个 模型上下文协议(MCP) 服务器构建于 祖普洛 演示了如何使用OpenAPI定义的API实现MCP工具和提示。
这个例子包括什么
该项目实现了 书签管理器 MCP集成展示了:
MCP工具
list-bookmarks-使用可选标签过滤列出已保存的书签save-bookmark-保存带有URL、标题和标签的新书签delete-bookmark-按ID删除书签
MCP提示
research-roundup-一个人工智能提示,分析最近的书签,以确定研究模式、主题,并建议下一步行动
关键组件
- 基于OpenAPI的路由 (
config/routes.oas.json)-带有MCP注释的API路线 - 书签处理程序 (
modules/bookmarks.ts)-使用基于缓存的存储进行CRUD操作,出于演示目的,这是“数据库”。 - 研究提示 (
modules/research-roundup-prompt.ts)-自定义MCP提示实施
入门指南
安装
npm install本地运行
启动开发服务器:
npm run devAPI将于 http://localhost:9000.
您可以访问:
- API网关 -
http://localhost:9000 - 当地API路线设计师 -
http://localhost:9100 - MCP端点 -
http://localhost:9000/mcp(职位)
当您修改以下内容时,开发服务器将自动重新加载:
- 中的路线定义
config/routes.oas.json - 处理器模块
modules/
使用Zuplo CLI进行部署
安装Zuplo命令行界面
npm install -g zuplo登录Zuplo
zuplo login创建新项目
zuplo init按照提示在您的Zuplo帐户中创建新项目。
部署到Zuplo
部署到工作拷贝环境:
zuplo deploy使用MCP服务器
部署后,您可以使用任何MCP客户端(如Claude Desktop)连接到MCP服务器。配置您的MCP客户端以指向:
本地开发人员
http://localhost:9000/mcp部署
https://your-project.zuplo.app/mcp服务器将公开:
- 3个管理书签的工具
- 分析你的研究模式的1个提示
