🗒️ 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桌面
- 下载并安装 克劳德桌面.
- 打开Claude Desktop并确保其正常工作。
2️ 找到Claude桌面配置文件夹
在…上 视窗，配置文件夹通常是：
C:\Users\\AppData\Roaming\Claude在macOS上，通常是：
~/Library/Application Support/Claude3.创建或编辑.claude-tools.json
.claude-tools.json4.添加您的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-notes2.将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中，您可以运行：
- “添加注释：明天购买杂货”
- “阅读所有便利贴”
- “我最近的便条是什么？”
- “总结我的笔记”
📽️ 演示视频
- 要攻击的链接