关于 mcp-client-and-server MCP server
mcp-client-and-server MCP server 是用于客户端与服务端串联的轻量笔记存储 MCP 服务。它提供笔记资源、添加笔记工具,以及可选择详略风格的笔记摘要提示词。
主要功能
- 01将笔记存为具名资源
- 02通过 note:// URI 访问笔记
- 03使用工具添加笔记
- 04通过提示词汇总已存笔记
- 05选择简要或详细的摘要风格
适用场景
- 01通过 MCP 客户端保存笔记
- 02检索单条已存笔记
- 03生成已存笔记的摘要
- 04选择简要或详细的摘要
MCP 相关
实现了包含笔记资源、`add-note` 工具和 `summarize-notes` 提示词的 MCP 服务。项目说明还将其描述为用于串联客户端与服务端的客户端和服务端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
mcp-client-and-server MCP 服务
用于在客户端和服务之间串联的 Model Context Protocol 客户端和服务端
组件
资源
该服务端实现了一个简单的笔记存储系统:
- 使用自定义的 note:// URI 方案访问单条笔记
- 每个笔记资源都有名称、描述和 text/plain MIME 类型
提示词
该服务端提供一个提示词:
- summarize-notes:为所有已存储的笔记生成摘要
- 可选的「style」参数,用于控制详细程度(简要/详细)
- 生成的提示词会结合所有当前笔记和风格偏好
工具
该服务端实现一个工具:
- add-note:向服务端添加新笔记
- 接受「name」和「content」作为必填字符串参数
- 更新服务端状态,并通知客户端资源发生变化
配置
[TODO:添加此实现的特定配置详情]
快速入门
安装
Claude Desktop
MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:%APPDATA%/Claude/claude_desktop_config.json
开发版/未发布服务的配置
``` "mcpServers": { "mcp-client-and-server": { "command": "uv", "args": [ "--directory", "/Users/mlrsmith/Library/Mobile Documents/com~apple~CloudDocs/Family_Shared/AI/mcp/mcp-client-and-server", "run", "mcp-client-and-server" ] } } ```已发布服务的配置
``` "mcpServers": { "mcp-client-and-server": { "command": "uvx", "args": [ "mcp-client-and-server" ] } } ```开发
构建和发布
准备分发软件包:
- 同步依赖项并更新锁文件:
uv sync
- 构建软件包分发文件:
uv build
这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。
- 发布到 PyPI:
uv publish
注意:你需要通过环境变量或命令标志设置 PyPI 凭据:
- 令牌:
--token或UV_PUBLISH_TOKEN - 或用户名/密码:
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于 MCP 服务通过 stdio 运行,调试可能颇具挑战。为获得最佳调试体验,我们强烈建议使用 MCP Inspector。
你可以通过 npm 使用以下命令启动 MCP Inspector:
npx @modelcontextprotocol/inspector uv --directory /Users/mlrsmith/Library/Mobile Documents/com~apple~CloudDocs/Family_Shared/AI/mcp/mcp-client-and-server run mcp-client-and-server
启动后,Inspector 会显示一个 URL,你可以在浏览器中访问该 URL 以开始调试。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。