使用说明
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
- 启动后端:
npm run web(端口3000) - 启动ChatGPT应用程序:
cd chatgpt-app && npm run dev(端口3001) - 用ngrok曝光:
ngrok http 3001 - 使用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
