Neuro Sync

🧠 NeuroSync MCP——开发人员生产力AI

NeuroSync通过拉取自动理解开发人员正在进行的工作 实时开发环境 通过MCP（模型上下文协议）从GitHub API、Hacker News和本地文件系统获取。

🌟 特性

• 实时上下文聚合：从GitHub REST+GraphQL API中提取数据
• 开发人员内存图：链接任务、问题、分支、提交和TODO
• 人工智能驱动的行动:

- ✅ 生成提交消息（OpenAI或回退） - ✅ 总结分支进展 - ✅ 建议下一步行动

• TODO提取：自动扫描代码库以查找TODO/FIXME注释
• 黑客新闻集成：显示开发人员见解的头条新闻
• MCP服务器集成：向LLM公开工具以获得上下文感知帮助
• 现代仪表板：漂亮的React UI，实时更新

⚙️ 技术栈

后端

• Java 21 + 弹簧靴3.2 （WebFlux）
• PostgreSQL （上下文持久性）
• 瑞迪斯 （短暂记忆）
• 梅文 （构建工具）

MCP服务器

• Node.js + TypeScript
• @模型上下文协议/sdk

前端

• 反应19 + 维特
• TailwindCSS + shadcn/ui （组件）
• TanStack查询 （国家管理）

基础设施

• Docker Compose （编排）
• DevContainer 兼容

🚀 快速开始

先决条件

• Docker&Docker编写
• GitHub个人访问令牌(在此处创建一个)
• （可选）OpenAI API密钥

设置

1. 克隆并导航到项目：

   cd NeuroSync

1. 创建 .env 文件：

   cp .env.example .env

1. 编辑 .env 并添加您的令牌：

   GITHUB_TOKEN=ghp_your_token_here
   GITHUB_REPO_OWNER=your-username
   GITHUB_REPO_NAME=your-repo
   OPENAI_API_KEY=sk-your_key_here  # Optional

1. 启动所有服务：

   docker-compose up -d

1. 访问仪表板：

- 前端：http://localhost:3000 - 后端API：http://localhost:8080/api

📁 项目结构

/neurosync-mcp
 ├─ /backend (Spring Boot)
 │   ├─ /src/main/java/com/neurosync
 │   │   ├─ controller/ContextController.java
 │   │   ├─ service/{GitHubService, ContextService}.java
 │   │   ├─ model/{DeveloperContext, ContextResponse}.java
 │   │   └─ repository/DeveloperContextRepository.java
 │   └─ Dockerfile
 ├─ /mcp-server (Node.js + TypeScript)
 │   ├─ src/
 │   │   ├─ index.ts
 │   │   └─ tools/githubTools.ts
 │   └─ package.json
 ├─ /frontend (React + Vite)
 │   ├─ src/
 │   │   ├─ App.tsx
 │   │   ├─ components/Dashboard.tsx
 │   │   ├─ services/api.ts
 │   │   └─ types/index.ts
 │   └─ Dockerfile
 ├─ docker-compose.yml
 ├─ .env.example
 └─ README.md

🧩 MCP服务器工具

MCP服务器向LLM公开以下工具：

1. getGitHubIssues(owner, repo) -获取未解决的问题
2. getRecentCommits(owner, repo, branch) -获取最近的提交
3. readActiveBranch(repoPath) -读取活动Git分支
4. writeToFile(filepath, text) -将内容写入文件

🔌 API终点

GET /api/context

聚合结构化开发人员上下文：

• 活动分支
• 未决问题
• 最近的提交
• TODO（来自文件）

答复：

{
  "activeBranch": "feature/new-feature",
  "openIssues": [...],
  "recentCommits": [...],
  "todos": ["[src/App.tsx] Fix authentication bug", ...],
  "metadata": {...}
}

POST /api/memory

在PostgreSQL中存储快照。

请求正文：

{
  "issueNumber": 123,
  "commitHash": "abc123",
  "branch": "main",
  "summary": "Working on feature X",
  "metadata": {...}
}

GET /api/memory/{id}

检索存储的上下文快照。

POST /api/ai/generate-commit-message

根据当前上下文生成提交消息。

答复：

{
  "message": "feat: add user authentication\n\n- Implemented login flow\n- Added JWT token handling"
}

POST /api/ai/summarize-progress

获取当前开发进度的摘要。

答复：

{
  "summary": "Working on feature branch 'auth'. 5 commits made, 2 issues open..."
}

POST /api/ai/suggest-next-step

获取AI对下一步开发的建议。

答复：

{
  "suggestion": "Consider working on issue #42: Add password reset functionality"
}

GET /api/hackernews?limit=5

获取热门黑客新闻故事（默认值：5）。

答复：

[
  {
    "id": 123456,
    "title": "Article Title",
    "url": "https://...",
    "score": 150,
    "by": "username",
    "time": 1234567890
  }
]

🗄️ 数据库模式

表： developer_context

🔒 环境变量

看 .env.example 对于所有可用变量。关键问题：

• GITHUB_TOKEN - 必需 -GitHub个人访问令牌
• GITHUB_REPO_OWNER -存储库所有者（例如“octocat”）
• GITHUB_REPO_NAME -存储库名称（例如“Hello World”）
• OPENAI_API_KEY -可选-用于AI摘要（如果未提供，则使用回退）
• TODO_SCAN_PATHS -扫描TODO的路径（默认值：“./”）
• POSTGRES_* -数据库配置
• REDIS_URL -Redis连接字符串

🛠️ 发展

后端（弹簧靴）

cd backend
mvn spring-boot:run

MCP服务器

cd mcp-server
npm install
npm run build
npm start

前端

cd frontend
npm install
npm run dev

📝 许可证

麻省理工学院

🤝 贡献

欢迎投稿！请打开问题或提交PR。

______________________________________________________________________

内置❤️ 对于希望人工智能理解其工作流程的开发人员。

\=======

🧠 神经同步

神经同步 是一个基于人工智能的开发人员分析和生产力平台，它统一了来自GitHub、数据库和Hacker News等社区来源的数据。\ 它提供实时见解、提交摘要和上下文智能，以帮助工程团队了解进度、计划下一步并保持同步。

______________________________________________________________________

🚀 主要特点

• 🔗 GitHub集成： 自动获取提交、问题和拉取请求。
• 🧩 混合数据架构： 结合PostgreSQL、Redis和AI模型实现实时性能。
• ⚙️ AI总结： 使用LLM从开发人员活动中生成智能摘要和见解。
• 📰 技术趋势提要： 提取顶级黑客新闻报道，以展示相关更新。
• 📊 交互式仪表板： 存储库、提交和系统健康状况的统一视图。
• 🧠 MCP集成： 公开与LLM和代理框架直接交互的工具。

______________________________________________________________________

🧰 技术栈

• 后端： Spring Boot（WebFlux、PostgreSQL、Redis、AI API）
• 前端： React+TypeScript+顺风
• AI层： 通过MCP的OpenAI API/本地LLM
• 基础设施： Docker Compose（PostgreSQL、Redis、后端、前端）

______________________________________________________________________

⚡ 快速开始

# Clone and run
git clone https://github.com//NeuroPulse.git
cd NeuroPulse
docker compose up -d --build
>>>>>>> e2ebb6119fdfd28c0f41ae39ed66f199c74108a1