AnythingLLM Integration - Claude Code Plugin

🚀 AnythingLLM 知识库集成 - 为 Claude Code 提供自动查询和智能同步功能

✨ 特性

• 🤖 自动查询 - Claude Code 自动优先查询本地知识库，无需手动指定
• 🌐 网络同步 - 一键从网络搜索并同步知识到 AnythingLLM
• 📁 智能组织 - 自动按主题分目录组织文件
• 🔄 自动去重 - 基于标题智能更新，避免重复文件
• 🔌 MCP 集成 - 完整的 MCP 服务器，提供 6 个工具接口
• 💬 斜杠命令 - 简单易用的命令行接口
• 💡 智能建议 - 使用 Hooks 智能建议查询知识库（非强制）

📦 快速开始

安装方式 1：使用 npm 包（推荐）

MCP 服务器已发布到 npm，无需克隆项目。

安装方式 2：从源码运行（开发者）

# 克隆项目
cd ~/projects
git clone https://github.com/youtao/anythingllm-integration.git
cd anythingllm-integration/mcp-server
npm install

⚙️ 配置

1. Claude Code MCP 配置

编辑 ~/.config/claude-code/config.json：

{
  "mcpServers": {
    "anythingllm": {
      "command": "node",
      "args": ["~/projects/anythingllm-integration/mcp-server/index.js"],
      "env": {
        "ANYTHINGLLM_BASE_URL": "http://192.168.3.100:3000/api",
        "ANYTHINGLLM_API_KEY": "your-api-key",
        "ANYTHINGLLM_WORKSPACE": "your-workspace-slug"
      }
    }
  }
}

2. 设置环境变量

# 临时设置（当前会话）
export ANYTHINGLLM_BASE_URL="http://192.168.3.100:3000/api"
export ANYTHINGLLM_API_KEY="your-api-key"
export ANYTHINGLLM_WORKSPACE="your-workspace-slug"  # 可选，默认使用第一个工作区

# 或添加到 ~/.bashrc 或 ~/.zshrc（永久）
echo 'export ANYTHINGLLM_BASE_URL="http://192.168.3.100:3000/api"' >> ~/.bashrc
echo 'export ANYTHINGLLM_API_KEY="your-api-key"' >> ~/.bashrc
echo 'export ANYTHINGLLM_WORKSPACE="your-workspace-slug"' >> ~/.bashrc
source ~/.bashrc

3. 智能查询建议（自动）

插件使用 Hooks 智能建议查询知识库，无需额外配置！

工作原理：

• 检测技术问题关键词（PostgreSQL、Vue、.NET 等）
• 显示知识库查询建议
• Claude 可以自主决定是否查询

详见下面的"强制查询"部分。

📖 使用

自动查询（无需命令）

直接提问技术问题：

PostgreSQL 18 性能优化有哪些具体改进？

Claude 会智能建议：

1. 检测到技术关键词时显示建议
2. 提供具体的搜索命令
3. AI 自主决定是否查询知识库

斜杠命令

/sync-knowledge "PostgreSQL 18"              # 网络搜索同步
/sync-knowledge "Vue 文档" ~/docs/guide.md     # 上传本地文件
/sync-knowledge "React 19" https://react.dev    # 抓取网页内容

智能识别：

• 仅主题 → 网络搜索
• 主题 + 文件路径 → 上传文件
• 主题 + URL → 抓取网页
• 无参数 → 交互模式

🎯 核心功能

1️⃣ MCP 服务器（5 个工具）

工具	描述	参数
anythingllm_search	向量搜索知识库	query (必需), workspace (可选)
anythingllm_list_workspaces	列出所有工作区	-
anythingllm_create_workspace	创建新工作区	name (必需)
anythingllm_upload_document	上传文档（支持文件夹）	workspace, filePath (必需), title, folder, metadata (可选)
anythingllm_list_documents	列出工作区文档	workspace (必需)

API 说明：

• 使用 /v1/document/raw-text 端点（官方标准）
• 自动处理向量嵌入，无需手动调用 update-embeddings
• 一步到位完成文档上传和工作区添加

2️⃣ 智能查询建议（Hooks）

自动建议，无需手动配置！

触发关键词：PostgreSQL, MySQL, 数据库, ABP, Vue, React, Angular, .NET, C#, TypeScript, JavaScript, Python, Java, Go, Rust, Node, API, REST, Docker, Kubernetes, Git, Linux 等

工作流程：

用户提问
  ↓
Hook 检测技术关键词
  ↓
显示知识库查询建议
  ↓
AI 自主决定是否查询
  ↓
基于判断选择最佳回答方式

Hook 配置（自动加载）：

• hooks/hooks.json - Hook 配置文件
• scripts/force-knowledge-query.sh - 强制查询脚本
• 使用标准 Plugin Hooks，优先级最高

3️⃣ 智能同步系统

• 网络搜索并同步知识
• 本地文件上传
• URL 内容抓取
• 智能文件组织（按主题分目录）
• 自动去重更新（基于标题）

📂 项目结构

anythingllm-integration/
├── .claude-plugin/
│   └── plugin.json              # Plugin 配置
├── hooks/
│   └── hooks.json               # Hook 配置
├── scripts/
│   └── force-knowledge-query.sh # 智能查询建议脚本
├── commands/                    # 斜杠命令
│   └── sync-knowledge.md       # 智能同步
├── mcp-server/                  # MCP 服务器
│   ├── index.js                # 主程序
│   └── package.json
├── .mcp.json                    # MCP 配置
├── package.json                 # 项目配置
├── README.md                    # 本文件
└── LICENSE                      # MIT 许可证

🧪 测试

测试自动查询

PostgreSQL 18 性能优化有哪些具体改进？

如果回答包含具体数据（如"查询编译速度提升 15%"），说明自动查询生效 ✅

测试 MCP 连接

# 测试 MCP 服务器启动
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node mcp-server/index.js

预期输出：显示 6 个工具的完整定义

测试网络同步

/sync-knowledge "Vue 3.5 新特性"

🐛 故障排查

自动查询不生效

1. 检查 Hook 是否加载
2. 确认 MCP 服务器正常运行
3. 重启 Claude Code

MCP 连接失败

1. 检查 ~/.config/claude-code/config.json 路径
2. 确认 Node.js >= 18.0.0
3. 运行 npm install
4. 验证环境变量已设置

同步失败

1. 确认 AnythingLLM API 可访问
2. 验证 API Key 正确性
3. 检查环境变量是否正确配置 (echo $ANYTHINGLLM_BASE_URL)

Hook 不执行

1. 验证 hooks/hooks.json 存在
2. 检查 scripts/force-knowledge-query.sh 有执行权限
3. 查看 Hook 配置是否正确

🔧 高级配置

自定义强制查询关键词

编辑 scripts/force-knowledge-query.sh：

TECH_KEYWORDS="PostgreSQL|Vue|您的关键词1|您的关键词2"

调试 Hook

# 查看 Hook 配置
cat hooks/hooks.json | jq .

# 测试 Hook 脚本
echo "PostgreSQL 问题" | scripts/force-knowledge-query.sh

📚 相关资源

• Claude Code Hooks 文档
• Claude Code MCP 文档
• AnythingLLM 文档

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

👨‍💻 作者

youtao

🙏 致谢

• AnythingLLM - 强大的本地知识库系统
• Claude Code - AI 驱动的代码编辑器

---

版本：1.6.3 更新日期：2026-02-10 状态：✅ 生产就绪

📝 更新日志

查看 CHANGELOG.md 了解完整版本历史和详细变更信息。

最新版本亮点 (v1.6.3)

• 🐛 修复上传文件后扩展名丢失的问题
• 🐛 修复 anythingllm_list_documents 和 anythingllm_search API 端点
• 🔄 优化 sync-knowledge 命令，移除冗余的 list_documents 校验