Focuspal Local MCP Server

🧠 FocusPal--人工智能生产力和情绪跟踪器（本地MCP服务器）

FocusPal 是当地人 MCP（模型上下文协议） 使用构建的服务器 FastMCP. 它对你有帮助 记录每日生产力，自动检测情绪，总结进度，并得到 基于人工智能的改进建议 --全部在里面 克劳德桌面.

______________________________________________________________________

🧩 特性

✅ 记录你的日常焦点或学习内容 ✅ 使用自动检测情绪 TextBlob情绪分析 ✅ 总结每周生产力统计数据 ✅ 获取个性化的人工智能建议，以获得更好的专注力 ✅ 使用轻量级本地数据库 SQLite （无需互联网）

______________________________________________________________________

⚙️ 安装

1.克隆存储库

git clone https://github.com/rishu5kumar/FocusPal-Local-MCP-Server.git
cd FocusPal-Local-MCP-Server

2.安装依赖项

确保你有 紫外线 安装并初始化。然后运行：

uv add fastmcp textblob numpy

______________________________________________________________________

🚀 将FocusPal作为本地MCP服务器运行

因为这是一个 本地MCP服务器，它使用 STDIO传输. 这意味着它直接在您的系统上运行，并在本地连接到Claude Desktop。

🧠 要将FocusPal连接到Claude Desktop，请执行以下操作：

在项目文件夹中运行一次：

uv run fastmcp install claude-desktop main.py

此命令：

• 启动本地MCP服务器(FocusPal)
• 在Claude Desktop中自动注册
• Claude现在可以在聊天中使用FocusPal工具

✅ 安装后，你会看到的 *FocusPal* 列在下面 克劳德→ 设置→ 工具→ 已安装的MCP服务器.

______________________________________________________________________

🔍 开发与测试

使用以下工具测试您的MCP服务器 MCP检查员 （安装前）：

uv run fastmcp dev main.py

然后打开MCP检查器（从FastMCP应用程序或CLI） 并输入默认URL：

http://127.0.0.1:6274/mcp

您将看到您的工具实时运行，例如：

• log_entry(date, hours, activity, mood, note)
• summarize_week(start_date, end_date)
• suggest_improvement(start_date, end_date)

______________________________________________________________________

💬 Claude中的命令示例

将FocusPal连接到Claude后，您可以说以下内容：

🗓️ “FocusPal，我今天学习了2.5个小时的日志，感觉很累。” 📊 “FocusPal，总结一下我从2025-11-01到2025-1-07的生产力。” 💡 “FocusPal，建议改善本周的焦点。”

______________________________________________________________________

📂 项目结构

focuspal/
├── main.py              # Main MCP server script
├── focuspal.db          # SQLite database (auto-created)
├── README.md            # You’re here
└── pyproject.toml

______________________________________________________________________

🧱 技术栈

• FastMCP –轻松创建MCP服务器
• SQLite –用于本地数据存储
• 文本块 –用于基于AI的情绪分析
• 数值Python –用于情绪统计和平均值

______________________________________________________________________

🧠 运作原理

1. 您使用以下方式记录您的日常活动 log_entry()

→ 如果你跳过 mood，它会从你的日记笔记中自动检测到。

1. 您可以通过以下方式查看您的每周总结 summarize_week()

→ 它显示了总小时数、频繁活动和平均情绪。

1. 您可以通过以下方式获取人工智能提示 suggest_improvement()

→ 它根据你的心情和平均工作时间给出建议。

______________________________________________________________________

🧰 示例代码段

uv run fastmcp install claude-desktop main.py

然后在克劳德：

“FocusPal，每周总结（'2025-11-01'，'2025-1-07'）”

______________________________________________________________________

🧑‍💻 开发人员说明

• 如果你修改 main.py，重新运行：

  uv run fastmcp install claude-desktop main.py

用最新版本更新Claude。

• 不需要互联网或身份验证——它是100%本地的。

• 要删除它，请转到Claude→ 设置→ 工具→ 已安装的MCP服务器→ 删除FocusPal。

______________________________________________________________________

🏁 总结

______________________________________________________________________