AI导哈

模型上下文协议服务器

高性能模型上下文协议服务器，提供长期记忆存储、语义和关键词搜索功能，以及结构化任务管理引擎。

  • by asd-noor
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 asd-noor/projectcontext

使用说明

项目上下文-MCP服务器

改进的继任者 代理商记忆

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

特性

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

安装

# Clone the repository
git clone <repo-url>
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或更高版本

相关 MCP