AI上下文记忆工具

为AI提供记忆功能的工具,可保存、搜索和管理项目上下文信息,适用于开发者和团队协作。

  • by Contextable-me
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Contextable-me/mcp

使用说明

@可上下文/mcp

给你的AI一个记忆。适用于Claude Desktop和任何兼容MCP的客户端。

快速启动(30秒)

添加到您的Claude Desktop配置中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "contextable": {
      "command": "npx",
      "args": ["@contextable/mcp"]
    }
  }
}

重新启动克劳德桌面。完成。

现在问克劳德: “创建一个名为My App的项目来跟踪我的开发决策”

你能做什么

保存对话中持续存在的上下文:

  • “将此架构决策保存到项目中”
  • “请记住此API设计,以便以后使用”
  • “保存此错误调查,这样我就不会忘记”

立即查找任何内容:

  • “搜索身份验证”
  • “我们对数据库做出了什么决定?”
  • “加载所有与安全相关的工件”

从你停止的地方继续:

  • “恢复我的项目”
  • “显示项目摘要”
  • “我们在做什么?”

导入您的聊天记录(新增):

  • “在~/Downloads/ChatGPT export.zip中分析我的ChatGPT导出”
  • “从我的聊天记录中导入‘React Development’项目”
  • “你能从我和克劳德的对话中发现什么项目?”

特性

特性 描述
项目 按项目或主题组织上下文
人工制品 保存决策、代码片段、文档、对话
全文检索 在所有项目中查找任何内容
版本历史 跟踪每次更改,随时回滚
汽车堵塞 大内容自动拆分
主题聚类 跨工件自动检测主题
聊天导入 从ChatGPT、Claude、Gemini导出

全部15个工具

项目

  • project_save -创建或更新项目
  • project_list -列出所有项目
  • project_resume -加载项目摘要
  • project_analysis_get -获取人工智能生成的见解

人工制品

  • artifact_save -保存内容(自动分块大文件)
  • artifact_list -列出尺寸估计值
  • artifact_get -加载完整内容
  • artifact_delete -存档(可恢复)
  • artifact_restore -恢复已存档
  • artifact_archived -列出存档项目
  • artifact_versions -查看历史记录
  • artifact_rollback -还原以前的版本

搜索

  • search -所有内容的全文搜索

导入(v0.2.0中的新功能)

  • import_analyze -分析来自ChatGPT、Claude或Gemini的聊天导出
  • import_seed -根据分析的聊天记录创建项目

您的数据

所有内容都存储在SQLite中:

~/.contextable/data.db

没有账号。没有云。没有追踪。您的数据保留在您的机器上。


想要更多?

上下文云 添加:

功能 本地 云
克劳德桌面 ✓ ✓
ChatGPT✓
Claude.ai(网络) - ✓
跨设备同步 - ✓
人工智能分析和见解 - ✓
团队分享 - 即将推出

尝试上下文云→


配置

环境变量

变量 默认值 描述
CONTEXTABLE_DATA_DIR ~/.contextable 数据目录
CONTEXTABLE_DB_PATH ~/.contextable/data.db SQLite数据库路径
CONTEXTABLE_LOG_LEVEL info 日志记录:调试、信息、警告、错误

自定义数据库位置

{
  "mcpServers": {
    "contextable": {
      "command": "npx",
      "args": ["@contextable/mcp"],
      "env": {
        "CONTEXTABLE_DB_PATH": "/path/to/my/data.db"
      }
    }
  }
}

HTTP模式(高级)

对于基于web的MCP客户端,请作为HTTP服务器运行:

npx @contextable/mcp --sse --port 3000

终点:

  • GET /health -健康检查
  • POST /mcp -MCP消息(JSON-RPC)

编程式用法

import { SQLiteAdapter } from '@contextable/mcp';

const storage = new SQLiteAdapter({ path: './my-context.db' });
await storage.initialize();

// Create a project
const project = await storage.createProject({
  name: 'My Project',
  description: 'Project description',
});

// Save an artifact
const artifact = await storage.createArtifact({
  projectId: project.id,
  title: 'Design Decision',
  artifactType: 'decision',
  content: '# We chose PostgreSQL because...',
});

// Search
const results = await storage.search('postgresql');

await storage.close();

发展

git clone https://github.com/Contextable-me/mcp.git
cd mcp
npm install
npm run build
npm test

许可证

Apache 2.0-请参阅 许可证

链接