mcp-client-and-server MCP server

mcp-client-and-server MCP server

site icon
2024.12.09 2
Python笔记管理客户端-服务器交互其它
mcp-client-and-server 是一个基于 Model Context Protocol (MCP) 的客户端和服务器实现,用于在客户端和服务器之间建立连接和交互。它提供了一个简单的笔记存储系统,支持自定义的 note:// URI 方案来访问单个笔记。每个笔记资源包含名称、描述和文本/纯文本的 MIME 类型。服务器还提供了一个提示功能来总结所有存储的笔记,并提供了一个工具来添加新笔记。
View on GitHub

Overview

基本能力

产品定位

mcp-client-and-server 是一个基于 Model Context Protocol (MCP) 的客户端和服务器实现,用于在客户端和服务器之间建立连接和交互。

核心功能

  1. 笔记存储系统
  2. 自定义 note:// URI 方案访问单个笔记
  3. 每个笔记资源包含名称、描述和文本/纯文本的 MIME 类型

  4. 提示功能

  5. summarize-notes: 创建所有存储笔记的摘要

    • 可选 "style" 参数控制详细程度(brief/detailed)
    • 生成结合所有当前笔记和风格偏好的提示
  6. 工具

  7. add-note: 添加新笔记到服务器
    • 需要 "name" 和 "content" 作为必需的字符串参数
    • 更新服务器状态并通知客户端资源变更

适用场景

  1. 需要客户端和服务器之间进行交互的应用
  2. 需要存储和管理笔记的应用
  3. 需要生成笔记摘要的应用

工具列表

  1. add-note
  2. 能力:添加新笔记到服务器
  3. 参数:"name" 和 "content" 作为必需的字符串参数

常见问题解答

  1. 调试困难
  2. 由于 MCP 服务器通过 stdio 运行,调试可能具有挑战性。
  3. 推荐使用 MCP Inspector 进行调试。

使用教程

使用依赖

  1. 确保已安装 Claude Desktop
  2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

安装教程

  1. 开发/未发布服务器配置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" ] } }

  2. 已发布服务器配置json "mcpServers": { "mcp-client-and-server": { "command": "uvx", "args": [ "mcp-client-and-server" ] } }

调试方式

  1. 使用 MCP Inspector 进行调试: bash 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

  2. 启动后,Inspector 将显示一个 URL,可以在浏览器中访问以开始调试。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。