笔记管理服务器

一个用于管理Markdown笔记并与ChatGPT集成的模型上下文协议服务器。

  • by Code-Genix
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Code-Genix/MCP-Server

使用说明

MCP Notes服务器

一个模型上下文协议服务器,用于通过ChatGPT集成管理markdown注释。

项目结构

MCP-Server-1/
├── src/                    # Core backend code
│   ├── index.ts           # MCP server (for Claude)
│   ├── web-server.ts      # REST API server
│   ├── storage/           # Notes storage
│   └── types.ts           # TypeScript types
├── chatgpt-app/           # ChatGPT integration (Next.js)
│   └── src/
│       ├── app/
│       │   ├── mcp/       # MCP endpoint
│       │   └── widgets/   # Interactive widgets
│       └── lib/           # Utilities & tools
├── notes-data/            # Notes storage directory
├── public/                # Web dashboard
└── tests/                 # Test files

快速开始

看 START.md 有关设置说明。

特性

  • ✅ 完整的CRUD操作(创建、读取、更新、删除注释)
  • ✅ 搜索和标签
  • ✅ 与Claude Desktop(MCP)配合使用
  • ✅ 使用ChatGPT(通过ChatGPT应用程序)
  • ✅ Web仪表板(浏览器UI)
  • ✅ Markdown支持
  • ✅ ChatGPT中的交互式小部件

用法

适用于克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/path/to/MCP-Server-1/dist/index.js"]
    }
  }
}

对于ChatGPT

  1. 启动后端: npm run web (端口3000)
  2. 启动ChatGPT应用程序: cd chatgpt-app && npm run dev (端口3001)
  3. 用ngrok曝光: ngrok http 3001
  4. 使用ngrok URL在ChatGPT中连接+ /mcp

用于Web浏览器

npm run web
# Visit: http://localhost:3000

脚本

npm run build    # Build TypeScript
npm start        # Start MCP server (for Claude)
npm run web      # Start web dashboard & API
npm test         # Run tests

技术栈

  • TypeScript
  • Node.js+Express
  • 模型上下文协议SDK
  • Next.js(用于ChatGPT集成)
  • React(用于小部件)
  • Zod(验证)
  • Vitest(测试)

有关详细设置,请参阅 START.md