Volcengine Knowledge Base MCP

基本能力

产品定位

Volcengine Knowledge Base MCP 是一个为 Claude Desktop 设计的火山引擎知识库服务器，提供知识库搜索和对话功能。

核心功能

• 🔍 知识库搜索
• 💬 对话补全
• 🔐 安全的凭证管理
• 🚀 简单易用的配置

适用场景

• 需要集成火山引擎知识库服务的 Claude Desktop 用户
• 需要安全管理和使用知识库的开发者和研究人员
• 需要高效搜索和对话补全功能的团队

工具列表

• configure: 配置火山引擎凭证和知识库设置
• search_knowledge: 搜索知识库
• chat_completion: 获取对话补全响应

常见问题解答

1. 确认凭证信息正确
2. 检查配置文件权限
3. 查看 Claude Desktop 日志文件
4. 如果需要重新配置，删除 ~/.config/volc_kb_mcp/config.json

使用教程

使用依赖

• Python 3.10 或更高版本
• Claude Desktop
• 你需要注册一个火山引擎账号，开通知识库服务，并且创建一个知识库

安装教程

1. 克隆仓库：

git clone [email protected]:suqidan/volc-kb-mcp.git
cd volc-kb-mcp

1. 安装依赖：

pip install -r requirements.txt

配置 Claude Desktop

编辑 Claude Desktop 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
    "mcpServers": {
        "kb": {
            "command": "python",
            "args": [
                "/path/to/kb_mcp.py"
            ]
        }
    }
}

使用方法

1. 首次使用时配置凭证：

await configure(
    access_key="your_access_key",
    secret_key="your_secret_key",
    account_id=your_account_id,
    collection_name="your_collection_name"
)

1. 搜索知识库：

result = await search_knowledge("你的查询")

1. 对话补全：

messages = [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "你好"}
]
response = await chat_completion(messages)

调试方式

1. 确认凭证信息正确
2. 检查配置文件权限
3. 查看 Claude Desktop 日志文件
4. 如果需要重新配置，删除 ~/.config/volc_kb_mcp/config.json

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。