AI导哈

个人助手功能系统

一个基于MCP协议的个人助手系统，提供笔记、待办事项、日程和书签管理功能，并与Cursor IDE集成。

  • by holelung
  • Vue
  • 本地部署
  • 更新于
在 GitHub 查看 holelung/mcp_agent

使用说明

🤖 个人助理MCP

使用模型上下文协议（MCP）的个人助理系统。您可以与Cursor IDE一起管理笔记、待办事项、日程安排和书签。

📁 项目结构

myMCP/
├── personal-assistant-mcp/       # MCP 서버 (Cursor IDE 연동)
├── personal-assistant-backend/   # REST API 서버
├── personal-assistant-dashboard/ # Vue.js 웹 대시보드
└── docker-compose.yml            # 통합 Docker Compose

主要功能

📝 管理注释

  • 创建、查询、修改和删除注释
  • 基于标签的分类
  • 全文搜索（Full-text search）

管理要做的事

  • 创建和完成待办事宜
  • 设置优先级（高/中/低）
  • 管理截止日期

📅 日程安排

  • 创建和管理日程表
  • 设置开始/结束时间
  • 添加地点信息

🔖 书签管理

  • 保存URL书签
  • 基于标签的分类
  • 添加评语

🔍 集成搜索

  • 搜索所有数据整合
  • 查看今天的摘要

🛠️ 技术堆栈

组件技术 |---------|------| |MCP서버 | Node.js、TypeScript、@modelcontextprotocol/sdk| |后端API | Express.js，TypeScript | 前端Vue3，Vite，Tailwind CSS |数据库| PostgreSQL 16 | |容器| Docker，Docker Compose

🚀 开始

前提条件

  • Node.js 20+
  • Docker&Docker编写
  • Cursor IDE（MCP客户端）

1.运行PostgreSQL

# 프로젝트 루트에서
docker-compose up -d postgres

2.构建MCP服务器

cd personal-assistant-mcp
npm install
npm run build

3.设置Cursor IDE

~/.cursor/mcp.json 将以下内容添加到文件：

{
  "mcpServers": {
    "personal-assistant": {
      "command": "node",
      "args": ["/path/to/myMCP/personal-assistant-mcp/dist/index.js"]
    }
  }
}

4.运行后端API（可选）

cd personal-assistant-backend
npm install
npm run dev

5.运行仪表板（可选）

cd personal-assistant-dashboard
npm install
npm run dev

🐳 在Docker上完整运行

# 모든 서비스 실행
docker-compose up -d

# 서비스 확인
docker-compose ps

服务端口说明 |--------|------|------| PostgreSQL 5432数据库 |后端API | 3001 | REST API서버 | | Dashboard | 5173 | Web仪表板|

📖 MCP工具列表

备忘录（Memo）

工具 说明
create_memo 创建新注释
list_memos 查看注释列表
get_memo 查看特定注释
update_memo 修改注释
delete_memo 删除注释

待办事宜（Todo）

工具 说明
create_todo 创建新待办事宜
list_todos 查询待办事项列表
get_todo 查询特定待办事宜
update_todo 修改待办事宜（包括完成处理）
delete_todo 删除待办事宜

计划（Schedule）

工具 说明
create_schedule 创建新日程表
list_schedules 查看日程表列表
get_schedule 查询特定日程表
update_schedule 修改日程表
delete_schedule 删除日程表

书签（Bookmark）

工具 说明
create_bookmark 创建新书签
list_bookmarks 查询书签列表
get_bookmark 查看特定书签
update_bookmark 修改书签
delete_bookmark 删除书签

效用

工具 说明
search_all 搜索所有数据整合
get_today_summary 今天的摘要

🏗️ 体系结构

┌─────────────────────────────────────────────────────────────┐
│                      사용자                                 │
│         ↓                              ↓                   │
│    Cursor IDE                    Web Browser               │
│         ↓                              ↓                   │
│  ┌─────────────┐              ┌─────────────────┐          │
│  │ MCP Server  │              │ Vue Dashboard   │          │
│  │ (stdio)     │              │ :5173           │          │
│  └──────┬──────┘              └────────┬────────┘          │
│         │                              │                    │
│         │                     ┌────────▼────────┐          │
│         │                     │ REST API Server │          │
│         │                     │ :3001           │          │
│         │                     └────────┬────────┘          │
│         │                              │                    │
│         └──────────────┬───────────────┘                   │
│                        ▼                                    │
│               ┌─────────────────┐                          │
│               │   PostgreSQL    │                          │
│               │   :5432         │                          │
│               └─────────────────┘                          │
└─────────────────────────────────────────────────────────────┘

📝 环境变量

PostgreSQL

DB_HOST=localhost
DB_PORT=5432
DB_NAME=personal_assistant
DB_USER=assistant
DB_PASSWORD=assistant123

后端API

API_PORT=3001

🤝 什么是MCP？

**MCP（Model Context Protocol）**是允许AI模型访问外部工具和数据的协议。

  • 服务器：定义工具和资源
  • 客户端：Cursor IDE等AI助手
  • 通信：JSON-RPC 2.0通过标准输入

有关详细信息，请访问 MCP官方文档请参阅。

📄 许可证

MIT许可证

相关 MCP