mcpField
M
mcp-client-and-server MCP server

mcp-client-and-server MCP server

本地服务
github.com/non-dirty开发工具299 周前更新

关于 mcp-client-and-server MCP server

mcp-client-and-server MCP server 是用于客户端与服务端串联的轻量笔记存储 MCP 服务。它提供笔记资源、添加笔记工具,以及可选择详略风格的笔记摘要提示词。

主要功能

  1. 01将笔记存为具名资源
  2. 02通过 note:// URI 访问笔记
  3. 03使用工具添加笔记
  4. 04通过提示词汇总已存笔记
  5. 05选择简要或详细的摘要风格

适用场景

  1. 01通过 MCP 客户端保存笔记
  2. 02检索单条已存笔记
  3. 03生成已存笔记的摘要
  4. 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" ] } } ```

开发

构建和发布

准备分发软件包:

  1. 同步依赖项并更新锁文件:
uv sync
  1. 构建软件包分发文件:
uv build

这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。

  1. 发布到 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 以开始调试。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。