使用说明

🧠 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密钥

设置

克隆并导航到项目：
```
cd NeuroSync
```
创建 .env 文件：
```
cp .env.example .env
```

编辑 .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

启动所有服务：
```
docker-compose up -d
```
访问仪表板：
- 前端：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公开以下工具：

getGitHubIssues(owner, repo) -获取未解决的问题
getRecentCommits(owner, repo, branch) -获取最近的提交
readActiveBranch(repoPath) -读取活动Git分支
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

列	类型	描述
`id`	UUID	主键
`timestamp`	TIMESTAMP	捕获上下文时
`issue_number`	INTEGER	相关GitHub问题
`commit_hash`	VARCHAR（40）	Git提交哈希
`branch`	VARCHAR（255）	Git分支名称
`summary`	文本	人类可读摘要
`metadata`	JSONB	附加上下文数据

🔒 环境变量

看 .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/<your-username>/NeuroPulse.git
cd NeuroPulse
docker compose up -d --build
>>>>>>> e2ebb6119fdfd28c0f41ae39ed66f199c74108a1

使用说明

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

🌟 特性

⚙️ 技术栈

后端

MCP服务器

前端

基础设施

🚀 快速开始

先决条件

设置

📁 项目结构

🧩 MCP服务器工具

🔌 API终点

GET /api/context

POST /api/memory

GET /api/memory/{id}

POST /api/ai/generate-commit-message

POST /api/ai/summarize-progress

POST /api/ai/suggest-next-step

GET /api/hackernews?limit=5

🗄️ 数据库模式

🔒 环境变量

🛠️ 发展

后端（弹簧靴）

MCP服务器

前端

📝 许可证

🤝 贡献

🧠 神经同步

🚀 主要特点

🧰 技术栈

⚡ 快速开始

相关 MCP

代码索引分析工具

开发者辅助工具

漏洞扫描服务

JADX APK逆向分析MCP插件

规范工作流管理工具

MongoDB 数据库 MCP 服务器

`GET /api/context`

`POST /api/memory`

`GET /api/memory/{id}`

`POST /api/ai/generate-commit-message`

`POST /api/ai/summarize-progress`

`POST /api/ai/suggest-next-step`

`GET /api/hackernews?limit=5`