使用说明
代理进度跟踪器MCP服务器
MCP（模型上下文协议）服务器，使AI代理能够跟踪、搜索和检索他们在项目中的进度。为多步骤或多代理工作流提供持久内存和上下文共享。
特性
- 日志进度 -使用结构化元数据记录已完成的工作
- 搜索日志 -按标题、日期、关键字或标签查找相关条目
- 获取上下文 -按ID检索先前工作的摘要信息
- 项目范围 -所有条目按项目组织，以保持上下文相关性
- LLM驱动的总结 -使用OpenAI兼容的API自动汇总
- SQLite存储 -具有全文搜索功能的快速本地数据库
- 全面的错误处理 -优雅的回退和详细的错误报告
快速开始
1.安装
npm install -g @thesammykins/agent-progress-mcp
2.配置API密钥
export OPENAI_API_KEY=your-api-key-here
3.添加到克劳德桌面
添加到您的Claude桌面 claude_desktop_config.json:
{
"mcpServers": {
"agent-progress": {
"command": "agent-progress-mcp",
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
}
}
4.开始跟踪进度
- 记录已完成的工作：
log_progress - 搜索以前的工作：
search_logs - 获取上下文：
get_context
文档
- 配置指南 -环境变量、MCP主机设置、替代提供商
- 开发指南 -贡献、测试、从源头构建
- 工具概述 -每个工具的技术细节
- 如何指导 -实际使用模式和工作流程
- 故障排除 -常见问题和解决方案
- 技术规范 -完整的技术规格
用法示例
# Log completed work
log_progress(
projectId="web-app",
title="Implemented JWT authentication",
content="Created JWT token generation/validation utilities, added auth middleware, implemented login/register endpoints with bcrypt password hashing. All tests passing.",
tags=["authentication", "security", "api"]
)
# Search for related work
search_logs(projectId="web-app", query="authentication")
# Get detailed context
get_context(projectId="web-app", id="found-entry-id", includeFull=true)
安装选项
开发安装
git clone https://github.com/thesammykins/context-mcp.git
cd context-mcp
npm install
npm run build
npm link # Optional: for local development
MCP主机集成
服务器可与任何兼容MCP的主机配合使用：
- 克劳德桌面版 -本地集成
- 光标 -添加到MCP服务器配置
- MCP-CLI -命令行使用
- 自定义主机 -STDIO传输协议
- OpenCode -添加到opencode.jsonc配置
OpenCode配置
添加到您的 opencode.jsonc:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"agent-progress": {
"type": "local",
"command": ["npx", "-y", "@thesammykins/agent-progress-mcp"],
"environment": {
"OPENAI_API_KEY": "{env:OPENAI_API_KEY}"
}
}
}
}
使用 use the agent-progress tool 在提示中启用进度跟踪。
数据库和隐私
- 本地存储：本地存储在计算机上的所有数据
- SQLite数据库：快速、可靠、基于文件的存储
- 可选加密：密码保护您的进度数据
- 无遥测：你的工作环境永远不会离开你的环境（除了可选的法学硕士总结）
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
贡献
我们欢迎捐款！请查看 开发指南 有关从源代码贡献、测试和构建的详细信息。
