projectcontext

项目上下文-MCP服务器

改进的继任者 代理商记忆

高性能MCP（模型上下文协议）服务器，提供具有语义和关键字搜索功能的长期内存存储，以及用于任务管理的结构化议程引擎。

特性

• 快速语义搜索：用途 fastembed 随着 BAAI/bge-small-en-v1.5 用于快速启动和低内存使用
• 混合搜索：使用交互排名融合（RRF）将关键字（FTS5）和向量搜索相结合
• 议程引擎：通过全文搜索计划和待办事项列表进行任务管理
• MCP提示：用于入职培训、功能规划和内存维护的专门工作流程
• 持久化存储：基于SQLite的存储 sqlite-vec 扩展
• 200毫秒以下的查询：将模型嵌入内存，以实现快速响应时间
• MCP本地：为AI代理本机公开工具、资源和提示

安装

# Clone the repository
git clone 
cd projectcontext

# Install dependencies with uv
uv sync

# Or install globally
uv pip install -e .

用法

运行服务器

# Run directly
projectcontext

# Or with uv
uv run projectcontext

MCP配置

添加到您的MCP客户端配置中（例如。， mcp.json):

{
  "mcpServers": {
    "projectcontext": {
      "command": "uv",
      "args": ["run", "projectcontext"],
      "cwd": "/path/to/projectcontext"
    }
  }
}

或者使用已安装的脚本：

{
  "mcpServers": {
    "projectcontext": {
      "command": "projectcontext"
    }
  }
}

MCP工具

内存引擎工具

• save_memory：保存包含类别、主题和内容的内存。
• query_memory：使用混合语义/关键字搜索搜索记忆。
• update_memory：按ID修改现有内存。
• delete_memory：按ID删除内存。

议程引擎工具

• create_agenda：创建一个新的多步骤计划或待办事项列表。
• list_agendas：显示所有活动或非活动议程。
• get_agenda：检索特定议程的详细任务信息。
• search_agendas：按标题或描述搜索计划。
• update_task：将任务标记为已完成或待处理。
• update_agenda：修改议程元数据或添加新任务。
• delete_agenda：删除不活动的议程。

MCP资源

projectcontext://usage-guidelines

为AI代理提供有关如何有效使用Memory和Agenda引擎的全面文档，包括分类最佳实践和幻觉预防。

projectcontext://schemas/{tool}

为特定工具提供JSON模式。这对于AI代理了解每个工具的必需和可选参数非常有用。

MCP提示

ProjectContext内置了提示，用于指导AI代理完成复杂的工作流程：

• setup_project_context：初始化新项目技术栈、目标和约定的模板。
• plan_feature_implementation：一个结构化的工作流程，用于搜索现有上下文并为新功能创建多步骤议程。
• summarize_and_remember：将对话历史提取为结构化记忆，同时避免重复。
• debug_with_history：利用过去的故障排除工作流程 bug_fix 内存和系统上下文。
• maintain_memory_health：用于识别和清理过时或冗余信息的主动维护工作流程。

建筑

技术栈

• 框架：FastMCP（Python MCP库）
• 嵌入：禁食(BAAI/bge-small-en-v1.5，384昏暗）
• 数据库：SQLite sqlite-vec 和 FTS5 扩展
• 沟通：基于标准输入的JSON-RPC

存储位置

数据库存储在 .ctxhub/ git根目录（或当前工作目录）中的目录。

• memory.sqlite：内存引擎数据库
• agenda.sqlite：议程引擎数据库

发展

项目结构

projectcontext/
├── src/
│   └── projectcontext/
│       ├── __init__.py      # Package initialization
│       ├── server.py        # MCP Server (Tools, Prompts, Resources)
│       ├── memory.py        # Memory Engine Logic
│       ├── agenda.py        # Agenda Engine Logic
│       └── database.py      # Database Utilities
├── pyproject.toml
└── .ctxhub/                 # Databases

测试

# Quick start: runs main tests and offers to start server
./quickstart.sh

# Run specific tests manually
uv run python tests/test_server.py
uv run python tests/test_updates.py

MCP检查员

npx @modelcontextprotocol/inspector uv run projectcontext

许可证

GPL-3.0或更高版本