Aljam3 MCP 服务器
一个提供访问Aljam3数字图书馆API的MCP（模型上下文协议）服务器。
功能
这个MCP服务器提供了与Aljam3数字图书馆交互的工具：
可用工具
- 列出作者 - 列出作者，可选搜索功能
- 获取作者 获取作者详情，可选扩展书籍信息
- 列出书籍 列出书籍，并可选择搜索功能
- 获取书籍 获取书籍详情，可选择扩展文件
- 列出类别 列出所有可用的类别
- 获取分类 获取类别详情，并可选择扩展书籍信息
- 列出库 列出所有可用的库
- 获取库 获取图书馆详细信息，并可选择扩展书籍信息
- 获取文件 获取文件详细信息，可选扩展页数
- 获取文件页面 获取特定文件的所有页面
- 搜索 在所有页面中进行搜索，并使用筛选选项
安装
- 克隆此存储库：
git clone
cd aljam3-mcp- 安装依赖项：
pip install -r requirements.txt用法
运行服务器
python server.py配置
服务器连接到Aljam3 API的时间为 https://aljam3.com 默认情况下。您可以修改 base_url 在 Aljam3Client 如需初始化类。
工具示例
搜索作者
# List authors with search query
await list_authors(q="محمد", limit=10)获取书籍详情及文件
# Get book by ID with file information
await get_book(book_id=123, expand_files=True)在所有书籍中搜索内容
# Search for specific content with filters
await search(
query="الفقه الإسلامي",
library=1,
categories=[5, 6],
limit=50
)API覆盖率
这个MCP服务器涵盖了Aljam3 OpenAPI规范中的所有端点：
/api/v1/authors- 作者列表和搜索/api/v1/authors/{id}- 个人作者详情/api/v1/books书籍列表和搜索/api/v1/books/{id}单本书的详细信息/api/v1/categories分类列表/api/v1/categories/{id}- 单个类别详情/api/v1/libraries- 库列表/api/v1/libraries/{id}单个库的详细信息/api/v1/files/{id}文件详情/api/v1/files/{file_id}/pages文件页面/api/v1/search全局内容搜索
开发
项目结构
aljam3-mcp/
├── server.py # Main MCP server implementation
├── requirements.txt # Python dependencies
├── pyproject.toml # Project configuration
├── swagger.yaml # API specification
└── README.md # This file依赖项
mcp>=1.0.0模型上下文协议框架httpx>=0.25.0- 用于API请求的现代HTTP客户端
许可证
麻省理工学院许可协议