使用说明

星期五MCP服务器

托尼·斯塔克级智能的专业人工智能助理

具有混合内存（Git+Upstash Redis）、单命令项目设置和智能上下文感知的个人AI代理。

✨ 特性

🚀 一个命令设置 - #friday-setup 初始化所有内容
🧠 混合存储器 -Git（结构化）+Redis（快速全局访问）
🤖 托尼·斯塔克Persona -专业、主动、精准
🔍 智能搜索 -基于所有来源的相关性
📊 自动检测 -确定项目类型和技术栈
💾 会话保持 -永远不要失去背景
🌍 始终可用 -离线工作，仅支持Git回退
💰 100%免费 -升级版免费版兼容

🚀 快速开始

安装

git clone https://github.com/angga13142/FRIDAY.git
cd friday-mcp-server
npm install

就是这样！ FRIDAY自动配置所有内容。

✅ 无需手动设置
✅ 无需凭据
✅ 立即工作（仅Git模式）
✅ Redis可选（如果需要，稍后添加）

VS代码集成

添加到 .vscode/settings.json 或用户设置：

{
  "mcp.servers": {
    "friday": {
      "command": "node",
      "args": ["/absolute/path/to/friday-mcp-server/dist/index.js"]
    }
  }
}

首先使用

#friday-setup

完成！ 星期五是活动和准备。

💡 什么 `npm install` 是否

自动设置（无需用户输入）：

✅ 安装依赖项
✅ 构建项目
✅ 创建 .env （仅Git模式）
✅ 设置内存结构
✅ 安装AI协议
✅ 配置Git挂钩
✅ 设置VS代码

总时间：~2分钟

看首次安装.md 了解详情。

🛠️ MCP工具

工具	说明	用法
周五设置	一个命令初始化	`#friday-setup web`
星期五搜索	混合语义搜索	`#friday-search "auth"`
星期五同步	Git→ Redis同步	`#friday-sync`
周五背景	加载项目上下文	`#friday-context`

🧠 混合存储器

Git Memory (Structured)          Redis Memory (Fast)
├── INDEX.md              ←─→    Session context
├── current-state.md      ←─→    Semantic cache
├── implementations/      ←─→    Quick notes
├── decisions/            ←─→    Cross-project data
└── issues/

模式：

混合（Git+Redis）-配置Uptash时
仅限Git -自动回退，无需Redis

🧪 测试

npm test              # Run all 32 tests
npm run build         # TypeScript compilation
npm run lint          # Code quality check

测试覆盖范围： 32/32传球✅

📊 建筑

FRIDAY MCP Server
├── Memory System
│   ├── GitMemoryManager (local structured docs)
│   ├── UpstashMemory (global fast cache)
│   └── HybridMemoryManager (intelligent fusion)
├── Tools (4 MCP tools)
├── Persona (Tony Stark AI)
└── Utils (auto-detection, config)

🤖 星期五人物

受托尼·斯塔克《星期五》启发的专业人工智能助理：

✅ 专业和尊重
✅ 主动解决问题
✅ 情境感知智能
✅ 清除状态更新
✅ 托尼·斯塔克级可靠性

例子：

User: "Setup this project"

FRIDAY: "Understood, Sir. Initializing...
✅ Setup complete.
Project: my-app | Type: Web | Memory: Hybrid
FRIDAY is now active. How shall we proceed?"

⚙️ 配置

看文件.md 获取完整的配置指南。

快速配置：

# .env
UPSTASH_REDIS_REST_URL=https://...
UPSTASH_REDIS_REST_TOKEN=...
FRIDAY_MEMORY_CAPACITY=100

📚 文档

🚀 发展

npm install           # Install dependencies
npm run dev           # Watch mode
npm test              # Run tests
npm run build         # Production build
npm start             # Run built version

💡 用例

🏗️ 新项目 -带内存的即时设置
🔍 代码发现 -快速查找实现
📝 文档 -自动跟踪决策
🤝 团队协作 -通过Redis共享上下文
🧠 上下文保护 -永不丢失项目状态

📈 演出

设置时间：<2s
搜索（Git）：<100ms
搜索（混合）：<50ms
内存：<50MB

🛡️ 安全

✅ 内存文件中没有秘密
✅ Redis凭据 .env （忽略）
✅ 仅本地执行
✅ 可选TLS加密

📝 许可证

麻省理工学院-参见许可证

🙏 致谢

内置：

@模型上下文协议/sdk
@upush/redis
TypeScript、Jest、Node.js

星期五-您的专业人工智能助手
始终运行。始终可靠。随时准备。

状态： 生产就绪✅
版本： 1.0.0
最后更新时间： 2025年11月8日

🤖 AI协议-星期五存储系统

重要提示：所有AI助手（GitHub Copilot，Claude，ChatGPT）都必须遵循此协议！

英文名称：Quick Start Commands

# 1️⃣ Awal session (WAJIB)
#friday-context

# 2️⃣ Sebelum implementasi (WAJIB)
#friday-search "<topik>"

# 3️⃣ Setelah perubahan (WAJIB)
#friday-sync

协议规则

设置检查：始终验证FRIDAY是否已初始化
上下文加载：在会话开始时加载上下文
存储器搜索：实施前搜索
文件：为更改创建内存文件
同步：更改后同步到Redis

📖 完整协议: .github/copilot-instructions.md