Non Dirty MCP Client And Server

一個實現MCP協議的客戶端和服務器項目，提供筆記存儲、摘要生成和筆記添加功能

筆記工具知識管理與記憶 #筆記管理 #協議服務 #摘要生成 .Python

評分 : 2分

下載量 : 12

更新時間 : 2025-04-29

什麼是MCP服務器？

MCP服務器是一個支持模型上下文協議的工具，允許用戶存儲、管理和生成筆記摘要。它通過自定義的note:// URI方案來訪問單個筆記，並提供生成摘要的功能。

如何使用MCP服務器？

用戶可以通過添加筆記、設置風格以及生成摘要來使用該服務器。服務器會自動更新筆記狀態並向客戶端發送更改通知。

適用場景

適用於需要高效管理筆記、生成摘要的個人或團隊，例如學生、研究人員和企業用戶。

主要功能

筆記存儲系統支持通過自定義note:// URI方案訪問和管理筆記。

生成摘要根據用戶選擇的風格（簡要/詳細）生成所有筆記的摘要。

添加新筆記支持通過命令行添加新的筆記並即時同步到服務器。

優勢與侷限性

優勢

簡單易用的命令行接口

支持多種風格的摘要生成

即時更新和通知機制

侷限性

依賴於命令行操作

對網絡環境有一定要求

如何使用

安裝MCP服務器

按照文檔中的指示下載並安裝MCP服務器。

啟動服務器

在終端中運行啟動命令以初始化服務器。

添加筆記

使用add-note命令添加新的筆記。

生成摘要

調用summarize-notes命令生成筆記摘要。

使用案例

添加筆記向服務器添加一條新的筆記。

生成摘要生成所有筆記的詳細摘要。

常見問題

如何安裝MCP服務器？

如何生成筆記摘要？

服務器是否支持即時更新？

🚀 MCP 客戶端和服務器

MCP（模型上下文協議）客戶端和服務端用於鏈條式連接客戶端與服務端，為客戶端與服務端的交互提供了有效的解決方案，增強了系統的連接性和交互性。

✨ 主要特性

資源

服務端實現了一個簡單的筆記存儲系統，具備如下功能：

自定義的 note:// URI 方案，可用於訪問單個筆記。
每個筆記資源包含名稱、描述和 text/plain MIME 類型。

提示語

服務端提供了一個提示語功能：

summarize-notes：能夠生成所有存儲筆記的摘要。
- 支持可選的“風格”參數，以此控制詳細程度（簡潔/詳細）。
- 可根據風格偏好生成包含所有當前筆記內容的提示語。

工具

服務端實現了一個實用工具：

add-note：可向服務端添加新的筆記。
- 接受“名稱”和“內容”作為必需字符串參數。
- 能夠更新服務端狀態並通知客戶端資源更改。

📦 安裝指南

在 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/ 目錄中創建源代碼和輪發行。

發佈到 PyPI

uv publish

⚠️ 重要提示 您需要通過環境變量或命令行參數設置 PyPI 憑證：

令牌：--token 或 UV_PUBLISH_TOKEN
或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試

由於 MCP 服務器通過標準輸入輸出運行，調試可能會有一定難度。💡 使用建議：為了獲得最佳調試體驗，我們強烈推薦使用 MCP 檢查器。

您可以通過以下命令啟動 MCP 檢查器：

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

啟動後，檢查器將在瀏覽器中顯示一個 URL，您可以在其中開始調試。