state-server MCP Server

基本能力

产品定位

mcp-state-server 是一个基于 Model Context Protocol (MCP) 的服务器，主要用于管理和操作文本笔记。

核心功能

1. 资源管理
2. 通过 note:// URI 列出和访问笔记
3. 每个笔记包含标题、内容和元数据

4. 使用纯文本 MIME 类型简化内容访问

5. 工具

6. create_note: 创建新的文本笔记

   • 需要标题和内容作为必填参数
   • 将笔记存储在服务器状态中

7. 提示

8. summarize_notes: 生成所有存储笔记的摘要
   • 包含所有笔记内容作为嵌入式资源
   • 返回结构化提示用于 LLM 摘要生成

适用场景

• 个人笔记管理
• 文本内容摘要生成
• MCP 协议的学习和演示

使用教程

使用依赖

安装项目依赖：

npm install

安装教程

1. 构建服务器：

npm run build

1. 开发时自动重建（可选）：

npm run watch

1. 与 Claude Desktop 一起使用，添加服务器配置：
2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "state-server": {
      "command": "/path/to/state-server/build/index.js"
    }
  }
}

调试方式

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。推荐使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL，可在浏览器中访问调试工具。

许可证

None