使用说明
AI自主数据管理器MCP
关于
AI自治数据管理器是一个专门的数据管理系统,旨在为AI代理(如Cursor、Cline或其他支持AI的编辑器中的代理)提供对动态结构化数据集合的自主控制。它使人工智能助手能够在无需人工干预的情况下,跨对话维护持久内存、组织信息和管理数据。
创建该服务器是为了练习了解MCP服务器。它有多有用还有待观察。它是根据麻省理工学院的许可证提供的。
主要特点:
- 人工智能驱动的集合创建,具有自动模式验证功能
- AI代理的自主CRUD操作
- 在聊天会话中生存的持久数据存储
- 支持STDIO和SSE(服务器发送事件)模式
该系统使AI代理能够执行以下操作:
- 在对话中建立和维护知识库
- 自主跟踪项目和任务
- 组织学习内容并生成测验
- 保存重要信息以备将来参考
查看和监控集合
当人工智能代理以编程方式与集合交互时,人类可以通过以下方式监视和检查数据:
- 在SSE模式下运行时,通过内置的web界面(http://localhost:3001)
- 使用MCP检查器工具(https://modelcontextprotocol.io/docs/tools/inspector)
- 通过MCP服务器API端点进行编程
要将收藏导出为PDF:
- 在SSE模式下运行时访问web界面
- 导航到所需的集合,然后单击PDF图标
收藏查看器的屏幕截图
入门
-
确保已安装Node和NPM
- 开发是使用Node版本22.14.0完成的,但其他版本可能也能工作
-
跑
npm install安装依赖项
在STDIO模式下运行
-
复制
run-example.sh向run.sh并设置正确的路径(到存储库目录) -
复制
.env-example向.env并在需要时进行修改(应按原样工作) -
使用启动MongoDB
docker-compose up或者使用您自己的Mongo实例- 如果使用自己的实例,请记住更改导出
MONGO_*和RUN_MODE环境变量run.sh相应地归档
- 如果使用自己的实例,请记住更改导出
-
配置编辑器/工具以使用MCP服务器
光标编辑器示例(
mpc.json):{ "mcpServers": { "data_service": { // Same repository path as mentioned above "command": "/<path>/run.sh", "args": [] } } }
在SSE模式下运行
注: 在SSE模式下运行有时似乎很粗略。虽然它对 MCP检查员 工具。当Cursor或Cline是客户端时,服务器有时会崩溃。因此,应该进行一些改进,使SSE模式更加坚固。
-
使用启动MongoDB
docker-compose up或者使用您自己的Mongo实例- 如果使用自己的实例,请记住更改导出
MONGO_*和RUN_MODE环境变量.env相应地归档
- 如果使用自己的实例,请记住更改导出
-
启动服务器:
npm start -
配置编辑器/工具以使用MCP服务器
光标编辑器示例(
mpc.json):{ "mcpServers": { "data_service": { "url": "http://localhost:3001/sse", } } }
使用脚本启动应用程序
NPM脚本
-
start- 使用以下命令直接从sourcecs启动后端 多伦多证券交易所.
- 从以下位置提供前端服务
dist/public/ - 未启用热重新加载
- 前端和后端都可以在端口3001上使用
-
dev:back- 在端口3001上启动后端
- 热重新加载已启用
-
dev:front- 在端口5173(默认Vite端口)上启动前端
- 热重新加载已启用
-
dev- 跑
dev:back和dev:front同时 - 前端和后端分别由端口5173和3001提供服务
- 两者都启用了热重新加载
- 跑
-
start:prod- 在中提供MCP服务器时运行此脚本 SSE 模式转换为LLM
- 构建应用程序
- 从运行应用程序
dist/,在端口3001上可用 - 无热装(显然)
外壳脚本
run.sh- 您不应该运行此shell脚本。相反,您将为LLM运行提供它。
- 设置环境变量(上述NPM脚本使用
dotenv) - 直接从运行应用程序
dist/在……里面 标准输入输出 模式 - 请注意,它不会为您编译应用程序,因此请务必事先这样做
可用资源
-
data://server-description服务器描述:数据服务及其用例的描述。
-
data://collections关于可用集合的元数据
可用工具
注: 本节不会详细解释每个工具。请检查一下
src/back-end/mcp/tools/_tools-schema.yml 在那里您可以看到为LLM提供的描述。
-
add_collection_type
在数据库中创建新的集合类型
-
add_batch_to_collection
向集合中添加一个或多个条目
-
get_from_collection
执行查询以从集合中检索条目
-
delete_from_collection
删除收藏条目
-
集合_摘要
获取集合摘要(返回所有条目,但仅包括
_id和summary字段) -
获取资源数据
提供的信息与
data://server-description和data://collections资源。 包含它的原因是,并非所有MCP客户端都支持资源。