AI导哈

AI便签服务器

一个基于MCP协议的自定义AI便签服务器，支持添加、读取、总结便签功能，适用于AI代理工具集成。

  • by priyaladesara
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 priyaladesara/mcp_py_ai

使用说明

🗒️ AI便签——自定义MCP服务器

这个项目很简单 MCP（模型上下文协议） 演示如何为AI代理公开工具、资源和提示的服务器（如 克劳德桌面)打电话。

它显示了如何创建自定义 便签服务器 通过MCP兼容客户端添加、阅读或总结笔记。

📌 什么是MCP？

主控程序 代表 模型上下文协议 --定义的标准 工具, 资源，以及 鼓励 AI模型可以在运行时动态调用。

在本项目中：

  • 这 MCP服务器 定义为 FastMCP （或您的自定义实现）
  • 这 客户端 是 克劳德桌面，它通过MCP协议调用服务器的工具

✅ 这个项目是做什么的？

  • 添加注释： 将便利贴保存到本地文本文件
  • 阅读备注： 返回所有已保存的笔记
  • 获取最新笔记： 仅返回最近的注释
  • 总结备注： 生成提示，让AI总结笔记

一切都保存在一个简单 notes.txt 服务器脚本旁边的文件。

⚙️ 它是如何工作的？

装饰器 用途 示例
@mcp.tool() 定义一个 工具 （动作）AI可以调用 add_note(), read_notes()
@mcp.resource() 定义一个 资源 （只读端点） get_latest_note()
@mcp.prompt() 定义一个 提示模板 note_Summary_prompt()

📌 如何将Claude Desktop设置为客户端并添加MCP服务器

按照以下步骤使Claude Desktop将您的自定义MCP服务器用作本地工具：

1️. 安装并打开Claude桌面

  1. 下载并安装 克劳德桌面.
  2. 打开Claude Desktop并确保其正常工作。

2️ 找到Claude桌面配置文件夹

在…上 视窗，配置文件夹通常是：

C:\Users\<YOUR_USERNAME>\AppData\Roaming\Claude

在macOS上，通常是：

~/Library/Application Support/Claude

3.创建或编辑.claude-tools.json

.claude-tools.json

4.添加您的MCP服务器配置

{
  "tools": [
    {
      "name": "StickyNotesServer",
      "type": "mcp",
      "mcp": {
        "url": "http://localhost:8000",
        "headers": {}
      }
    }
  ]
}

快速开始

1.克隆存储库

git clone https://github.com/your-org/ai-sticky-notes.git
cd ai-sticky-notes

2.将MCP添加到python项目中

创建一个uv管理项目：

uv init mcp-server-demo
cd mcp-server-demo

然后将MCP添加到您的项目依赖关系中：

uv add "mcp[cli]"

或者，对于使用pip作为依赖关系的项目：

pip install "mcp[cli]"

3.示例用法

在Claude Desktop中，您可以运行：

  • “添加注释：明天购买杂货”
  • “阅读所有便利贴”
  • “我最近的便条是什么？”
  • “总结我的笔记”

📽️ 演示视频

  • 要攻击的链接

相关 MCP