Package Exports

alou-graph-mcp
alou-graph-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (alou-graph-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Alou Graph MCP

一个智能文件知识图谱MCP服务器，通过AI驱动的语义搜索和关系发现，帮助您更好地理解和管理文件系统。

功能特性

🔍 智能搜索

全局语义搜索: 根据关键词、文件名或内容查找文件
跨文件夹关联: 发现分散在不同文件夹中的相关文件
主题搜索: 按主题（AI、编程、文档等）搜索文件
模糊搜索: 支持不精确的文件名匹配

🔗 关系发现

文件关系分析: 自动分析文件间的相似性和关联性
跨文件夹链接: 发现跨文件夹的文件关联
智能分类: 基于文件名、内容、时间等维度进行文件分类

📁 文件系统监控

全驱动器扫描: 扫描所有驱动器（包括U盘）
实时监控: 监控文件变化和可移动设备
增量更新: 支持增量索引更新

安装和使用

全局安装

npm install -g alou-graph-mcp

启动服务器

alou

开发模式

如果您想从源码运行：

git clone https://github.com/logos-42/alou-graph-mcp.git
cd alou-graph-mcp
npm install
npm run build
npm start

MCP工具列表

文件系统工具

scan_all_drives - 扫描所有驱动器
monitor_removable_devices - 监控可移动设备
sync_knowledge_graph - 同步知识图谱
get_scan_status - 获取扫描状态

搜索工具

global_semantic_search - 全局语义搜索
find_related_files_across_folders - 跨文件夹查找相关文件
search_by_topic - 按主题搜索
find_file - 根据文件名查找文件
get_file_info - 获取文件详细信息

关系工具

analyze_file_relationships - 分析文件关系
discover_cross_folder_links - 发现跨文件夹关联
get_file_relationships - 获取文件关系
get_relationship_analysis - 获取关系分析报告

使用示例

扫描所有驱动器

{
  "name": "scan_all_drives",
  "arguments": {
    "excludePatterns": ["node_modules", ".git"],
    "maxFileSize": 104857600
  }
}

全局语义搜索

{
  "name": "global_semantic_search",
  "arguments": {
    "query": "AI研究报告",
    "limit": 10,
    "searchType": "hybrid"
  }
}

分析文件关系

{
  "name": "analyze_file_relationships",
  "arguments": {
    "folderPath": "/path/to/folder",
    "similarityThreshold": 0.7
  }
}

配置说明

配置文件 config.json 包含以下设置：

database: 数据库配置
scanning: 扫描设置（排除模式、文件大小限制等）
search: 搜索配置（默认限制、最小分数等）
relationships: 关系分析配置
monitoring: 监控设置
performance: 性能优化设置

技术架构

核心组件

FileKnowledgeDatabase: SQLite数据库存储
FileScanner: 文件系统扫描器
SemanticSearchEngine: 语义搜索引擎
RelationshipFinder: 关系发现算法

技术栈

TypeScript: 类型安全的JavaScript
SQLite: 轻量级数据库
Fuse.js: 模糊搜索
Natural: 自然语言处理
Chokidar: 文件系统监控

性能指标

扫描速度: 10,000文件/分钟
搜索响应: <100ms（10万文件）
内存占用: 200MB（10万文件）
启动时间: <5秒

开发计划

基础文件扫描和索引
语义搜索引擎
关系发现算法
MCP工具接口
用户模式学习
智能建议系统
高级语义搜索
文件组织建议

许可证

MIT License

贡献

欢迎提交Issue和Pull Request！