AI导哈

工作流MCP服务器

一个专注于日常工作效率的MCP服务器，提供笔记管理、文件操作和知识捕获功能。

  • by ColeMei
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 colemei/my-mcp-server

使用说明

Cole的日常工作流MCP服务器

A. 简化模型上下文协议 服务器专注于日常生产力工作流程。使用Python和FastMCP库对笔记管理、文件操作和知识捕获进行了优化。

🚀 项目状态

✅ 精简且专注 -每日工作流程优化的MCP服务器，具有：

  • 8个用于笔记和文件的基本工具
  • 5个用于工作空间洞察的智能资源
  • 4个提高生产力的工作流程提示
  • 基于SQLite的笔记管理
  • 干净、简约的架构

🎯 核心理念

少即是多：此服务器在80%的时间里专注于您使用的20%的功能：

  • 快速捕获和搜索笔记
  • 工作区的文件操作
  • 日常工作流程的智能提示
  • 没有API干扰或未使用的实用程序

🌟 特性

📝 笔记和知识管理

  • 快速捕捉笔记 quick_note()
  • 智能笔记搜索 find_notes()
  • 通过以下方式访问最近的笔记 recent_notes()
  • 自定义SQL查询 sql_query()

📁 文件和项目操作

  • 读取任何文本文件 read_file()
  • 使用以下方式保存内容 save_file()
  • 目录探索 explore_directory()
  • CSV分析 analyze_csv()

📊 智慧资源

  • 工作区概述和统计数据
  • Notes数据库模式和见解
  • 系统状态监控
  • 文件元数据访问
  • 配置管理

💡 工作流提示

  • 日常回顾和笔记分析
  • 项目清理和组织
  • 代码审查工作流程
  • 知识差距识别

🏗️ 建筑

服务器遵循 干净的模块化架构 明确区分关注点：

my-mcp-server/
├── .env.example        # Environment configuration template
├── .gitignore          # Git ignore rules
├── README.md           # Documentation
├── requirements.txt    # Python dependencies
├── setup_dev.sh        # One-command setup script (source it!)
├── data/               # SQLite database (auto-created)
├── logs/               # Application logs (auto-created)
├── mcp-env/            # Virtual environment (auto-created)
├── tests/              # Test suite
│   └── test_server.py  # Functionality verification tests
└── src/                # Main source code
    ├── server.py       # Main MCP server (streamlined & focused)
    ├── config/         # Configuration & settings
    ├── tools/          # Core business logic (database & file tools)
    ├── resources/      # System information & metadata handlers
    ├── prompts/        # Daily workflow templates
    └── utils/          # Shared utilities (logging, validation)

🚀 快速开始

先决条件

  • Python 3.10+
  • macOS/Linux（zsh/bash shell）

一个命令设置⚡

source ./setup_dev.sh

此单个命令将：

  • ✅ 创建虚拟环境
  • ✅ 在当前shell中激活它
  • ✅ 安装所有依赖项
  • ✅ 创建必要的目录
  • ✅ 清理缓存文件

重要：使用 source ./setup_dev.sh （不是 ./setup_dev.sh)以确保虚拟环境在当前shell中保持激活状态。

运行服务器

mcp dev src/server.py

MCP检查员将在 http://127.0.0.1:6274 🎉

环境配置（可选）

复制 .env.example 向 .env 并自定义：

cp .env.example .env

配置示例：

SERVER_NAME=MyMCPServer
DEBUG=false
LOG_LEVEL=INFO
API_TIMEOUT=30
MAX_FILE_SIZE=10485760

🛠️ 可用工具（共8个）

📝 笔记管理

  • quick_note(title: str, content: str) -快速捕捉想法和想法
  • find_notes(search_term: str) -搜索您的笔记
  • recent_notes(limit: int = 10) -获取您最近的笔记
  • sql_query(query: str, params: tuple = None) -自定义数据库查询

📁 文件操作

  • read_file(file_path: str) -读取任何文本文件
  • save_file(file_path: str, content: str) -将内容保存到文件
  • explore_directory(directory_path: str) -浏览目录内容
  • analyze_csv(file_path: str, max_rows: int = 100) -快速CSV分析

📊 可用资源（共5个）

  • notes://schema -Notes数据库结构和统计
  • workspace://current -当前工作区概述和文件计数
  • system://status -系统信息（操作系统、Python版本等）
  • config://current -当前服务器配置
  • project://file/{file_path} -详细的文件元数据和信息

💡 可用工作流提示（共4个）

  • daily_review(focus: str = "recent") -查看并分析您最近的笔记
  • project_cleanup() -组织和清理您当前的项目
  • code_review(language: str = "python") -审查代码质量和最佳实践
  • knowledge_gaps() -找出知识库中的差距

🔧 配置

服务器使用 Pydantic设置 具有环境变量支持：

设置 默认值 环境变量 说明
server_name 《科尔日报》 SERVER_NAME 服务器标识符
debug false DEBUG 调试模式切换
log_level “信息” LOG_LEVEL 记录冗长
api_timeout 30 API_TIMEOUT 请求超时（未来使用）
max_file_size 10MB MAX_FILE_SIZE 最大文件大小

🗂️ 数据管理

  • Notes数据库：SQLite存储在 data/app.db 具有自动模式创建功能
  • 日志：每日轮换日志 logs/ 调试目录
  • 配置: .env 个性化设置的文件支持

🧪 测试与开发

使用MCP检查器

MCP检查器提供了一个web界面，用于：

  • 浏览并测试所有可用工具
  • 查看资源模式和实时数据
  • 测试提示模板
  • 实时监控服务器日志
  • 调试协议通信

添加新功能

  1. 新刀具：添加到适当 tools/*.py 提交并注册 server.py
  2. 新建资源：添加到 resources/*.py 并使用URI模板注册
  3. 新建提示：添加到 prompts/template_prompts.py 并注册 server.py

📦 依赖项

在中查看 requirements.txt

🤝 整合

此MCP服务器可以与以下设备集成：

  • 克劳德桌面 -添加到 claude_desktop_config.json
  • 自定义AI应用程序 -用作MCP协议服务器
  • 开发工具 -通过MCP检查器进行测试，如Cursor、VSCode

Claude桌面配置示例：

{
  "mcpServers": {
    "cole-daily-mcp": {
      "command": "uv",
      "args": ["run", "--with", "mcp", "mcp", "run", "src/server.py"],
      "cwd": "/path/to/my-mcp-server"
    }
  }
}

📈 业绩说明

  • 文件操作：针对最大10MB的文件进行了优化
  • 数据库：SQLite具有高效的笔记搜索索引
  • 记忆：轻量化设计，仅专注于基本操作
  • 初创公司：快速初始化，依赖性最小

🎯 有什么不同？

这个精简版本侧重于：

✅ 仅限基本工具：8个精心挑选的日常生产力工具 ✅ 直观的命名: quick_note() 而不是 create_note()
✅ 以工作流为中心：为实际日常使用而设计的提示 ✅ 降低复杂性：删除了未使用的API和实用工具 ✅ 更好的默认值：合理的限制和配置 ✅ 明确目的：笔记管理+文件操作=生产力

📚 额外资源

  • 工作流_示例.md -实际使用示例和日常集成
  • MCP检查员 -用于测试和开发的Web界面http://127.0.0.1:6274
  • 日志 -每日登录 logs/ 故障排除目录

专为日常生产力而设计 | MCP文件

相关 MCP