WeKnora MCP Server
这是一个 Model Context Protocol (MCP) 服务器，提供对 WeKnora 知识管理 API 的访问。
快速开始
推荐直接参考 MCP配置说明，无需进行以下操作。
1. 安装依赖
pip install -r requirements.txt
2. 配置环境变量
# Linux/macOS
export WEKNORA_BASE_URL="http://localhost:8080/api/v1"
export WEKNORA_API_KEY="your_api_key_here"
# Windows PowerShell
$env:WEKNORA_BASE_URL="http://localhost:8080/api/v1"
$env:WEKNORA_API_KEY="your_api_key_here"
# Windows CMD
set WEKNORA_BASE_URL=http://localhost:8080/api/v1
set WEKNORA_API_KEY=your_api_key_here
3. 运行服务器
推荐方式 - 使用主入口点：
python main.py
其他运行方式：
# 使用原始启动脚本
python run_server.py
# 使用便捷脚本
python run.py
# 直接运行服务器模块
python weknora_mcp_server.py
# 作为 Python 模块运行
python -m weknora_mcp_server
4. 命令行选项
python main.py --help # 显示帮助信息
python main.py --check-only # 仅检查环境配置
python main.py --verbose # 启用详细日志
python main.py --version # 显示版本信息
安装为 Python 包
从 PyPI 安装
pip install weknora-mcp
PyPI 包名为
weknora-mcp（请勿与第三方包weknora-mcp-server混淆）。 安装后命令行入口仍为weknora-mcp-server/weknora-server。
开发模式安装
pip install -e .
安装后可以使用命令行工具：
weknora-mcp-server
# 或
weknora-server
生产模式安装
pip install .
构建分发包
# 使用 setuptools
python setup.py sdist bdist_wheel
# 使用现代构建工具
pip install build
python -m build
测试模组
运行测试脚本验证模组是否正常工作：
python test_module.py
功能特性
该 MCP 服务器提供以下工具：
空间管理
create_tenant- 创建新空间list_tenants- 列出所有空间
知识库管理
create_knowledge_base- 创建知识库list_knowledge_bases- 列出知识库get_knowledge_base- 获取知识库详情delete_knowledge_base- 删除知识库hybrid_search- 混合搜索
知识管理
create_knowledge_from_url- 从 URL 创建知识list_knowledge- 列出知识get_knowledge- 获取知识详情delete_knowledge- 删除知识
模型管理
create_model- 创建模型list_models- 列出模型get_model- 获取模型详情
会话管理
create_session- 创建聊天会话get_session- 获取会话详情list_sessions- 列出会话delete_session- 删除会话
聊天功能
chat- 发送聊天消息
块管理
list_chunks- 列出知识块delete_chunk- 删除知识块
故障排除
如果遇到导入错误，请确保：
- 已安装所有必需的依赖包
- Python 版本兼容（推荐 3.10+）
- 没有文件名冲突（避免使用
mcp.py作为文件名）
调用效果
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
weknora_mcp-1.1.0.tar.gz
(136.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file weknora_mcp-1.1.0.tar.gz.
File metadata
- Download URL: weknora_mcp-1.1.0.tar.gz
- Upload date:
- Size: 136.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1a4337109ee99305cac22e29e05f3ecba3549101972a2424eba32c3eb2d15fc9
|
|
| MD5 |
fbde46fc51ff7b1b3345f85fab72db3e
|
|
| BLAKE2b-256 |
8e07aa1ed3560a439f2c16551bcb9b8ea537356f35f58e81a922de45124c675b
|
Provenance
The following attestation bundles were made for weknora_mcp-1.1.0.tar.gz:
Publisher:
mcp-server.yml on annopick/WeKnora
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
weknora_mcp-1.1.0.tar.gz -
Subject digest:
1a4337109ee99305cac22e29e05f3ecba3549101972a2424eba32c3eb2d15fc9 - Sigstore transparency entry: 2287810390
- Sigstore integration time:
-
Permalink:
annopick/WeKnora@9eec98e5ed59d46582c196f7f8479085e52eaa94 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/annopick
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
mcp-server.yml@9eec98e5ed59d46582c196f7f8479085e52eaa94 -
Trigger Event:
push
-
Statement type:
File details
Details for the file weknora_mcp-1.1.0-py3-none-any.whl.
File metadata
- Download URL: weknora_mcp-1.1.0-py3-none-any.whl
- Upload date:
- Size: 23.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c7bdc60ab87d647f99170d13f605565993ba9e4267c80e14c5d0a2e1b19f122d
|
|
| MD5 |
829a17361f2f5380e0e8472636a0eaac
|
|
| BLAKE2b-256 |
283788ce440797864ac723821cd26ed9ba99d17995e88a6db51e062458d933d5
|
Provenance
The following attestation bundles were made for weknora_mcp-1.1.0-py3-none-any.whl:
Publisher:
mcp-server.yml on annopick/WeKnora
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
weknora_mcp-1.1.0-py3-none-any.whl -
Subject digest:
c7bdc60ab87d647f99170d13f605565993ba9e4267c80e14c5d0a2e1b19f122d - Sigstore transparency entry: 2287810408
- Sigstore integration time:
-
Permalink:
annopick/WeKnora@9eec98e5ed59d46582c196f7f8479085e52eaa94 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/annopick
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
mcp-server.yml@9eec98e5ed59d46582c196f7f8479085e52eaa94 -
Trigger Event:
push
-
Statement type:
