mcp-client-and-server MCP server

mcp-client-and-server MCP server

site icon
2024.12.27 0
Python笔记管理摘要生成开发效率
non-dirty_mcp-client-and-server 是一个基于 Model Context Protocol (MCP) 的客户端和服务器实现,用于在客户端和服务器之间建立连接和交互。该服务器主要实现了一个简单的笔记存储系统,支持自定义的 note:// URI 方案来访问单个笔记。每个笔记资源包含名称、描述和纯文本类型。服务器提供了一个提示功能(summarize-notes)来生成所有存储笔记的摘要,并支持通过 'style' 参数控制摘要的详细程度(brief/detailed)。此外,服务器还实现了一个工具(add-note)来添加新笔记到服务器。
View on GitHub

Overview

基本能力

产品定位

non-dirty_mcp-client-and-server 是一个基于 MCP 协议的笔记存储和摘要生成服务,旨在提高开发效率和信息管理能力。

核心功能

  1. 笔记存储系统
  2. 支持自定义 note:// URI 方案访问单个笔记
  3. 每个笔记包含名称、描述和纯文本类型
  4. 提示功能
  5. summarize-notes:生成所有存储笔记的摘要
    • 可选 "style" 参数控制摘要详细程度(brief/detailed)
  6. 工具功能
  7. add-note:添加新笔记到服务器
    • 需要 "name" 和 "content" 作为必填字符串参数

适用场景

  1. 开发者在多个客户端之间共享和管理笔记
  2. 需要快速生成笔记摘要以提高信息处理效率的场景
  3. 需要集中存储和访问笔记的开发环境

工具列表

  1. add-note
  2. 功能:添加新笔记到服务器
  3. 参数:"name"(笔记名称)和 "content"(笔记内容)

常见问题解答

  1. 如何调试 MCP 服务器?
  2. 推荐使用 MCP Inspector 进行调试
  3. 启动命令:npx @modelcontextprotocol/inspector uv --directory [路径] run mcp-client-and-server

使用教程

使用依赖

  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 开始调试

开发

构建和发布

  1. 同步依赖并更新锁文件: bash uv sync
  2. 构建包分发: bash uv build
  3. 发布到 PyPI: bash uv publish
  4. 需要设置 PyPI 凭据(通过环境变量或命令标志)

许可证

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