Appearance
Anteey MCP 客户端新手使用指南
🚀 让 AI 助手访问你的个人笔记库
说明：该功能的使用需要具备一定的动手能力，我已经尽量将文档写得新手友好，Bug 问题我会尽快修复，关于如何安装和使用等问题，就不做一一解答了，还请谅解！
📖 什么是 Anteey MCP 客户端？
Anteey MCP 客户端是一个桥梁，让 AI 助手（如 Raycast、Cursor、Claude）能够访问和搜索你在 Anteey 笔记应用中的个人笔记。
简单来说：就像给 AI 助手装了一个"记忆库"，让它能记住你写过的所有笔记！
🎯 使用场景
- 项目回顾：让 AI 帮你回顾之前的项目笔记
- 学习复习：搜索相关的学习笔记和知识点
- 写作灵感：从你的笔记中寻找创作素材
- 会议准备：快速查找相关的会议记录
- 知识查询：在个人知识库中搜索答案
📋 准备工作
1. 确保 Anteey 应用正在运行
- 打开 Anteey 笔记应用
- 进入 设置 → MCP 服务
- 启用 MCP 服务
- 复制显示的 API 密钥（以
anteey_开头）
2. 确认网络连接
确保你的电脑能正常访问网络，因为需要下载一些必要的组件。
🛠️ 安装步骤
方法一：一键安装（推荐）
打开终端（Terminal），复制粘贴以下命令：
bash
npm install -g @geekmai/anteey-mcp-client方法二：如果上面的命令不工作
bash
# 先安装 Node.js（如果还没有的话）
# 访问 https://nodejs.org 下载安装
# 然后运行安装命令
npm install -g @geekmai/anteey-mcp-client⚙️ 配置设置
1. 自动配置（最简单）
在终端中运行：
bash
anteey-mcp discover这个命令会自动找到你的 Anteey 应用并配置连接。
2. 手动配置
如果自动配置不成功，运行：
bash
anteey-mcp config按提示输入：
- API 密钥：从 Anteey 设置中复制的密钥
- 服务器地址：通常是
http://localhost:43211/api/mcp
3. 测试连接
bash
anteey-mcp test看到 "✅ 所有测试通过！" 就说明配置成功了！
🎨 在不同 AI 工具中使用
🔍 Raycast 集成
1. 启动 Raycast 适配器
在终端中运行：
bash
anteey-mcp raycast重要：保持这个终端窗口开着，不要关闭！
2. 配置 Raycast
- 按
⌘ + ,打开 Raycast 设置 - 找到 Extensions → MCP Servers
- 点击 Add Server，填入：
名称: anteey
命令: npx
参数: -y @geekmai/anteey-mcp-client raycast
环境变量:
ANTEEY_MCP_API_KEY: [你的API密钥]
ANTEEY_MCP_BASE_URL: http://localhost:43211/api/mcp
描述: 访问我的 Anteey 笔记3. 自定义指令（可选但推荐）
在 Raycast 设置中添加自定义指令：
主动搜索和引用我的 Anteey 笔记来回答问题。优先使用我笔记中的信息，提供基于我个人知识库的个性化回答。适用于项目查询、学习复习、知识整理等场景。4. 开始使用
在 Raycast 中搜索任何问题，AI 会自动搜索你的笔记来回答！
💻 Cursor 集成
1. 配置 Cursor
- 打开 Cursor 设置
- 找到 MCP Servers 部分
- 添加新服务器：
json
{
"name": "anteey",
"command": "npx",
"args": ["-y", "@geekmai/anteey-mcp-client", "cursor"],
"env": {
"ANTEEY_MCP_API_KEY": "[你的API密钥]",
"ANTEEY_MCP_BASE_URL": "http://localhost:43211/api/mcp"
}
}2. 重启 Cursor
保存配置后重启 Cursor 应用。
3. 开始使用
在 Cursor 聊天中使用 @anteey 来搜索你的笔记：
@anteey 帮我找一下关于 JavaScript 的笔记🤖 Claude Desktop 集成
1. 找到配置文件
macOS：~/Library/Application Support/Claude/claude_desktop_config.jsonWindows：%APPDATA%\Claude\claude_desktop_config.json
2. 编辑配置文件
在 mcpServers 部分添加：
json
{
"anteey": {
"command": "npx",
"args": ["-y", "@geekmai/anteey-mcp-client", "claude"],
"env": {
"ANTEEY_MCP_API_KEY": "[你的API密钥]",
"ANTEEY_MCP_BASE_URL": "http://localhost:43211/api/mcp"
}
}
}3. 重启 Claude Desktop
保存文件后重启 Claude Desktop 应用。
4. 开始使用
直接问 Claude 任何问题，它会自动搜索你的笔记来回答！
🎯 使用技巧
1. 提问技巧
好的提问方式：
- "帮我找一下关于项目管理的笔记"
- "我写过关于 React 的学习笔记吗？"
- "搜索一下最近关于 AI 的思考"
避免的提问：
- "搜索笔记"（太模糊）
- "找东西"（不够具体）
2. 常用功能
- 搜索笔记：查找包含特定关键词的笔记
3. 最佳实践
- 保持 Anteey 应用运行
- 定期整理和更新笔记
- 使用清晰的笔记标题和标签
- 在提问时使用具体的关键词
🐛 常见问题
Q: 提示"无法连接到 Anteey 服务器"
A: 确保 Anteey 应用正在运行，并且 MCP 服务已启用
Q: API 密钥验证失败
A: 检查密钥是否正确，确保以 anteey_ 开头
Q: 搜索结果为空
A: 尝试更宽泛的搜索词，或者检查笔记中是否包含相关内容
Q: AI 工具无法识别服务
A: 确保配置正确，并重启相应的 AI 工具
Q: 终端显示错误信息
A: 运行 anteey-mcp test 来诊断问题
🔄 更新和维护
更新客户端
bash
npm update -g @geekmai/anteey-mcp-client重置配置
bash
anteey-mcp config --reset🆘 获取帮助
如果遇到问题：
- 查看测试结果：运行
anteey-mcp test - 检查配置：运行
anteey-mcp config --list - 重新配置：运行
anteey-mcp config - 查看帮助：运行
anteey-mcp --help
🎉 开始使用
现在你已经完成了所有设置！试试问 AI 助手：
- "帮我找一下关于 [你的项目] 的笔记"
- "搜索一下我最近的学习笔记"
- "我写过关于 [某个主题] 的内容吗？"
AI 会智能地搜索你的笔记库，给你个性化的回答！
享受你的智能笔记助手！ 📚✨