Graph Memory Ide

GraphMemory集成开发环境

  

用于IDE的人工智能辅助长期存储系统，由 立体主义 图形数据库。GraphMemory IDE是一个MCP（模型上下文协议）服务器，提供语义向量搜索、基于图的知识存储和实时分析。它通过专用的IDE插件与VSCode、Cursor和Windsurf集成。

特性

• 基于图形的内存存储 --具有语义向量搜索的Kuzu原生图数据库（HNSW索引、句子转换嵌入）
• Codon加速图算法 --通过以下方式进行可选的本地编译 鳕鱼 通过自动Python/NetworkX回退，中心性、社区检测、路径分析和相似性计算的速度提高了10-100倍
• FastAPI后端 -具有JWT身份验证（EdDSA/Ed25519）、速率限制和安全中间件的异步API
• 实时分析 --用于实时遥测仪表板的WebSocket和SSE流
• 流线型仪表板 --图形指标、用户活动和系统健康状况的交互式可视化
• 多IDE插件支持 --VSCode、Cursor和Windsurf的扩展
• 完全可观察性 --Prometheus指标、Grafana仪表板、健康检查和警报相关性
• 生产就绪的Docker部署 --使用Nginx、PostgreSQL、Redis和监控栈的多服务Docker Compose

快速开始

Docker（推荐）

git clone https://github.com/elementalcollision/GraphMemory-IDE.git
cd GraphMemory-IDE/docker
docker compose up -d

服务将在以下地点提供：

• MCP服务器：http://localhost:8080/docs
• Kestra（工作流编排）：http://localhost:8081

本地开发

# Install dependencies
pip install -r requirements.txt

# Start the FastAPI server
uvicorn server.main:app --host 0.0.0.0 --port 8080 --reload

# Start the Streamlit dashboard (separate terminal)
cd dashboard
streamlit run streamlit_app.py

环境变量

建筑

GraphMemory IDE使用混合架构，其中I/O绑定代码（FastAPI、数据库客户端、WebSocket）在CPython中运行，而计算量大的图算法可以选择作为本机编译的Codon模块运行。

IDE Plugins (VSCode/Cursor/Windsurf)
        |
        v
  FastAPI Server (CPython)
   ├── JWT Auth + Security Middleware
   ├── MCP Protocol Handler
   ├── Telemetry Ingestion
   └── Analytics Engine
        |
   ┌────┴────┐
   v         v
Kuzu DB   Redis Cache
(graphs)  (sessions)
   |
   v
Codon Bridge (optional)
 ├── Graph Kernels (.so/.dylib)
 └── Python/NetworkX fallback

看 架构概述 详细的系统设计。

Codon加速度

这 codon/ 目录包含通过Codon编译为本机机器代码的图形算法实现。桥梁层(codon/bridge/)根据图大小和库可用性自动路由计算：

• 图形内核：介数/亲密度/度中心性、PageRank、标签传播、Louvain社区检测、BFS/Dijkstra最短路径
• 数据处理：余弦相似性、批处理向量操作、一致散列
• 后备方案：如果Codon库没有编译，所有操作都会透明地回退到NetworkX/numpy

使用以下代码编译Codon模块：

./scripts/build_codon.sh

项目结构

GraphMemory-IDE/
├── server/                # FastAPI backend
│   ├── main.py            # Application entry point
│   ├── core/              # Configuration and settings
│   ├── auth/              # SSO, MFA, onboarding
│   ├── auth_jwt.py        # JWT authentication
│   ├── analytics/         # Analytics engine
│   ├── collaboration/     # Real-time collaboration
│   ├── dashboard/         # Dashboard API routes
│   ├── monitoring/        # Health checks, metrics, alerting
│   ├── security/          # Security middleware
│   ├── streaming/         # WebSocket/SSE streaming
│   └── graph_database.py  # Kuzu DB integration
├── dashboard/             # Streamlit UI
├── frontend/              # TypeScript/React frontend
├── codon/                 # Codon acceleration layer
│   ├── bridge/            # Python-Codon interop with fallback
│   ├── graph_kernels/     # Native graph algorithms (.codon)
│   └── data_processing/   # Native data operations (.codon)
├── docker/                # Docker Compose configs
│   ├── docker-compose.yml # Development environment
│   └── production/        # Production multi-service setup
├── tests/                 # Test suites
│   ├── integration/       # Integration tests
│   ├── production/        # Production validation
│   ├── load_testing/      # Locust load tests
│   └── smoke/             # Smoke tests
├── docs/                  # Documentation
├── ide-plugins/           # VSCode, Cursor, Windsurf extensions
├── monitoring/            # Prometheus & Grafana configs
├── scripts/               # Build and deployment scripts
└── kubernetes/            # Kubernetes manifests

测试

# Run all tests
PYTHONPATH=. pytest tests/ -v

# Run with coverage
PYTHONPATH=. pytest tests/ --cov=server --cov-report=html

# Run specific test categories
PYTHONPATH=. pytest tests/ -m unit
PYTHONPATH=. pytest tests/ -m integration
PYTHONPATH=. pytest tests/ -m "not slow"

测试标记： unit, integration, e2e, api, database, authentication, analytics, performance, slow

覆盖目标：最低85%。

生产部署

对于生产，使用多服务Docker Compose配置：

cd docker/production
cp .env.example .env  # Configure environment variables
docker compose -f docker-compose.prod.yml up -d

这将启动7+服务：Nginx（反向代理）、FastAPI、Streamlit、Analytics、PostgreSQL、Redis、Prometheus和Grafana——具有隔离的网络子网和资源限制。

请参阅 获取完整的生产设置说明。

文档

贡献

看 贡献指南 用于开发工作流、提交约定和代码审查过程。

许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。