AI便签服务

一个基于MCP协议的AI便签服务器,提供创建、读取和管理持久化便签的功能,适用于AI助手和开发效率工具集成。

  • by guokang73098204
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 guokang73098204/mcp-server

使用说明

AI便签MCP服务器

一种模型上下文协议(MCP)服务器,提供人工智能驱动的便利贴功能。该服务器允许AI助手通过一个简单的基于文件的系统创建、读取和管理持久笔记。

特性

  • 添加注释:将新注释附加到持久文件
  • 阅读笔记:检索所有已保存的笔记
  • 最新笔记资源:通过MCP资源访问最新添加的注释
  • 注释摘要提示:生成提示,让AI总结当前笔记

工具

add_note(message: str)

将新便笺附加到便签文件。

参数:

  • message (str):要添加的注释内容

退货:

  • 确认消息,指示注释已保存

read_notes()

读取并返回便利贴文件中的所有笔记。

退货:

  • 所有音符都是由换行符分隔的单个字符串
  • 如果没有笔记,则“还没有笔记”

资源

notes://latest

返回最近添加的注释。

提示词

note_summary_prompt()

生成提示,让AI汇总所有当前笔记。

安装

先决条件

  • Python 3.12或更高版本
  • 紫外线 (推荐)或pip

使用紫外线(推荐)

# Install dependencies
uv sync

# Run the server
uv run mcp install main.py

使用pip

# Install dependencies
pip install -r requirements.txt

# Run the server
python main.py

配置

服务器将笔记存储在 notes.txt 文件与位于同一目录中 main.py。该文件在首次使用时自动创建。

使用Claude Desktop

要将此MCP服务器与Claude Desktop一起使用,请将以下内容添加到您的Claude Desktop配置文件中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ai-sticky-notes": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Study\\opensource\\my-project\\mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

将路径替换为实际的项目目录。

发展

项目结构

mcp-server/
├── main.py           # MCP server implementation
├── notes.txt         # Persistent note storage
├── pyproject.toml    # Project dependencies
└── README.md         # This file

依赖项

  • mcp[cli]>=1.21.0 -模型上下文协议实现

许可证

[在此处添加您的许可证]

贡献

欢迎投稿!请随时提交拉取请求。

作者

国康73098204