使用说明
@可上下文/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-请参阅 许可证
