Cogniz内存平台-MCP服务器
官方 模型上下文协议(MCP) 服务器 Cogniz存储平台 -使像克劳德这样的人工智能助手能够存储和检索对话中的记忆。
🌐 实时服务器: https://app.cogniz.online/mcp
______________________________________________________________________
✨ 特性
- 🔌 MCP协议2025-03-26 -最新的流式HTTP传输
- 🔐 多住户 -每个用户都使用自己的API密钥
- 🧠 持久存储器 -跨会话存储和检索上下文
- 🔍 语义搜索 -使用自然语言查找相关记忆
- 📁 项目组织机构 -按项目组织记忆
- 💾 自动压缩 -无损压缩可节省65%的存储空间
- 🌍 远程访问 -适用于Claude桌面和Web UI
______________________________________________________________________
🚀 快速开始
适用于Claude桌面用户
1.获取API密钥:
- 访问 cogniz.online/仪表板
- 导航至 API 参考 章节
- 复制API密钥(格式:
mp_1_XXXXXXXXXXXX)
2.配置克劳德桌面:
打开您的Claude Desktop配置文件:
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
添加此配置:
{
"mcpServers": {
"cogniz-memory": {
"url": "https://app.cogniz.online/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}替换 YOUR_API_KEY_HERE 使用您的实际API密钥。
3.重新启动克劳德桌面
4.测试:
You: "Store a memory: MCP integration is working!"
Claude: "I've stored that memory in your Cogniz account."验证它是否出现在您的 仪表盘.
______________________________________________________________________
适用于Web UI用户(ChatGPT Web UI、Claude Web UI等)
Web UI通常无法发送自定义标头,因此我们支持 查询参数身份验证.
方法1:自定义连接器(如果支持)
一些Web UI支持自定义连接器:
- 首选 设置→ 连接器
- 添加自定义连接器:
- 姓名: Cogniz存储平台 - 网址: https://app.cogniz.online/mcp?api_key=YOUR_API_KEY - 方法: 发布
方法2:带有API密钥的URL
使用此URL格式:
https://app.cogniz.online/mcp?api_key=YOUR_API_KEY⚠️ 安全说明: 查询参数的安全性低于标头,因为它们出现在日志和URL中。仅对不支持授权标头的Web UI使用此方法。
______________________________________________________________________
🛠️ 可用工具
连接后,Claude可以使用这些MCP工具:
cogniz_store_memory
在Cogniz平台中存储新内存。
参数:
content(必填):要存储的文本/信息project_id(可选):项目标识符(默认值:“default”)project_name(可选):人类可读的项目名称category(可选):类别标签(例如,“代码片段”、“会议笔记”)
例子:
"Store this code snippet in my development project: async function fetchData() { ... }"______________________________________________________________________
cogniz_search_memories
使用语义搜索搜索记忆。
参数:
query(必填):搜索文本project_id(可选):将搜索限制到特定项目limit(可选):最大结果(1-100,默认值:10)
例子:
"Search my memories for API authentication examples"______________________________________________________________________
cogniz_list_projects
列出你的所有项目。
例子:
"Show me all my projects"______________________________________________________________________
cogniz_get_stats
查看您的使用统计数据。
退货:
- 当前计划
- 内存使用
- API调用
- 项目计数
- 存储统计数据
例子:
"How much memory am I using?"______________________________________________________________________
cogniz_delete_memory
按ID删除特定内存。
参数:
memory_id(必填):要删除的内存ID
例子:
"Delete memory mem_12345"______________________________________________________________________
🔐 身份验证方法
此服务器支持 两种身份验证方法 与不同的客户合作:
方法1:授权标头(推荐)
最适合: Claude Desktop,API客户端,安全环境
格式:
POST /mcp HTTP/1.1
Authorization: Bearer mp_1_YOUR_API_KEY
Content-Type: application/json赞成的意见:
- ✅ 更安全
- ✅ 在URL/日志中不可见
- ✅ 标准HTTP身份验证
______________________________________________________________________
方法2:查询参数
最适合: 无法发送自定义标头的Web UI
格式:
https://app.cogniz.online/mcp?api_key=mp_1_YOUR_API_KEY赞成的意见:
- ✅ 适用于Web UI
- ✅ 不需要标头支持
欺骗:
- ⚠️ 不太安全(在URL中可见)
- ⚠️ 出现在服务器日志中
- ⚠️ 可能被代理缓存
______________________________________________________________________
📊 定价计划
MCP服务器是 免费使用。您只需为您的Cogniz Memory Platform帐户付款:
| 计划 | 价格 | 内存限制 | 项目 | API调用/月 |
|---|---|---|---|---|
| 启动器 | 免费(30天) | 100 MB | 3 | 1000 |
| 加 | 每月7美元 | 无限制 | 15 | 15000 |
| 专业版 | 49美元/月 | 无限制 | 无限制 | 100000 |
| 企业 | 自定义 | 无限 | 无限 | 无限制 |
______________________________________________________________________
🧪 测试
健康检查
curl https://cogniz-claude-mcp.onrender.com/health预期响应:
{
"status": "healthy",
"service": "cogniz-mcp-server"
}测试身份验证(标头方法)
curl -X POST https://app.cogniz.online/mcp \
-H "Authorization: Bearer mp_1_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'测试身份验证(查询方法)
curl -X POST "https://app.cogniz.online/mcp?api_key=mp_1_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'预期: 5个可用MCP工具列表
______________________________________________________________________
🏗️ 自我寄宿
想运行自己的实例吗?克隆和部署:
先决条件
- Node.js 18+
- TypeScript
- 渲染帐户(或任何Node.js宿主)
部署以渲染
1.分叉此存储库
2.在渲染时创建Web服务:
- 连接你的GitHub分支
- 构建命令:
npm install && npm run build - 启动命令:
npm start - 环境变量:
- COGNIZ_BASE_URL=https://cogniz.online - COGNIZ_PROJECT_ID=default - 可选: COGNIZ_API_KEY (仅用于演示/测试)
3.配置自定义域(可选):
- 需要专业计划(19美元/月)
- 添加CNAME:
your-subdomain.com→your-service.onrender.com - SSL自动配置
4.更新OAuth发现URL: 在 src/server-remote.ts 第224行:
resource: "https://your-domain.com/mcp",5.部署和测试!
______________________________________________________________________
📚 文档
- MCP协议: https://modelcontextprotocol.io
- Cogniz平台: https://cogniz.online/documentation
- API参考: https://cogniz.online/dashboard#api-参考文献
- 技术支持: https://cogniz.online/contact
______________________________________________________________________
🔧 发展
本地设置
# Clone repository
git clone https://github.com/cognizonline/Cogniz_Claude_MCP.git
cd Cogniz_Claude_MCP
# Install dependencies
npm install
# Build TypeScript
npm run build
# Set environment variables
export COGNIZ_BASE_URL=https://cogniz.online
export COGNIZ_API_KEY=mp_1_YOUR_TEST_KEY
# Start server
npm start
# Server runs on http://localhost:3000本地测试
# Health check
curl http://localhost:3000/health
# List tools
curl -X POST http://localhost:3000/mcp \
-H "Authorization: Bearer mp_1_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'______________________________________________________________________
🤝 贡献
欢迎投稿!拜托:
- 分叉存储库
- 创建要素分支
- 进行更改
- 彻底测试
- 提交拉取请求
______________________________________________________________________
📋 故障排除
“需要身份验证”错误
原因: 未提供API密钥
修复:
- 桌面:添加
Authorization: Bearer YOUR_KEY要配置 - Web UI:添加
?api_key=YOUR_KEY到URL
“API密钥无效”(401错误)
原因: API密钥错误或已过期
修复:
- 从获取新的API密钥 仪表盘
- 验证格式:
mp_1_XXXXXXXXXXXX
“超出速率限制”(429错误)
原因: 超过每月API调用限制
修复:
- 在仪表板中检查使用情况
- 更多通话的升级计划
- 每月重置限额
连接超时
原因: 免费渲染计划上的服务器(冷启动)
修复:
- 等待30-60秒进行预热
- 或者升级到专业计划(每月19美元)以获得永远在线
______________________________________________________________________
💰 托管成本
免费渲染计划
- ✅ 永远免费
- ⚠️ 冷启动(怠速15分钟后延迟30-60s)
- ⚠️ 有限的资源
专业渲染计划(每月19美元)
- ✅ 始终开启(无冷启动)
- ✅ 更好的性能
- ✅ 自定义域名
- ✅ 优先支持
建议用于生产。
______________________________________________________________________
🔒 安全
API关键安全
- ✅ 仅通过HTTPS传输密钥
- ✅ 服务器不存储密钥(无状态)
- ✅ 每个请求都是隔离的
- ✅ SSL/TLS加密
最佳实践
- 永远不要将API密钥提交到git
- 尽可能使用授权标头 (比查询参数更安全)
- 定期旋转按键
- 监控使用情况 可疑活动
- 仅对Web UI使用查询参数 不支持标头
______________________________________________________________________
🌐 协议细节
MCP版本
2025-03-26 (流式HTTP)
运输
支持流媒体的HTTP POST
端点
POST /mcp-主MCP端点GET /health-健康检查GET /.well-known/oauth-protected-resource-身份验证发现
支持的方法
tools/list-列出可用工具tools/call-执行工具resources/list-列出资源(未来)
______________________________________________________________________
📞 支持
- 问题:
- 电子邮件: support@cogniz.online
- 文档: cogniz.online/文档
______________________________________________________________________
📄 许可证
MIT许可证-有关详细信息,请参阅许可证文件
______________________________________________________________________
🙏 致谢
- 建立在 模型上下文协议 通过Anthropic
- 由...驱动 Cogniz存储平台
- TypeScript+Express+MCP SDK
______________________________________________________________________
🔄 更新日志
v1.2.0(最新版本-2025年1月)
- ✅ 使用用户提供的API密钥支持多租户
- ✅ 授权头身份验证(推荐)
- ✅ 查询参数身份验证(适用于Web UI)
- ✅ 改进了错误消息
- ✅ OAuth发现元数据
v1.1.0(2024年10月)
- ✅ 更新为MCP流式HTTP协议(2025-03-26)
- ✅ 修复了API字段映射
- ✅ 改进了错误处理
v1.0.0
- 初始版本
- 基本MCP工具
- 可流式HTTP传输
______________________________________________________________________
实时MCP服务器: https://app.cogniz.online/mcp
获取API密钥: https://cogniz.online/dashboard
需要帮助? 打开问题或联系support@cogniz.online
______________________________________________________________________
由以下材料制成❤️ 对于AI社区
