Moss MCP服务器
一种模型上下文协议（MCP）服务器，用于使用 Moss REST API.
✨ 主要特点
- 语义索引管理：创建、列出和删除针对低于10ms性能优化的向量索引。
- 高效的文档处理：轻松添加、更新和删除文档。
- 基于REST的管理：直接从您的AI助手完全控制您的Moss项目。
- 无缝集成Claude：已为Claude Desktop预配置。
🚀 入门指南
1.先决条件
- Python 3.10或更高版本
- Moss项目（注册 portal.usemoss.dev)
2.安装
pip install fastmcp httpx inferedge-moss python-dotenv3.设置凭据
- 去 莫斯门户.
- 创建或选择一个项目。
- 获取您的
PROJECT_ID和PROJECT_KEY从项目设置中。
4.环境变量
创建一个 .env 项目目录中的文件：
MOSS_PROJECT_ID="your_project_id"
MOSS_PROJECT_KEY="your_project_key"🛠️ 工具参考
Moss MCP服务器公开了以下工具：
| 工具 | 参数 | 说明 |
|---|---|---|
create_index | index_name, documents, model_id? | 创建新的语义搜索索引。 |
get_index | index_name | 检索特定索引的元数据。 |
list_indexes | - | 列出项目中的所有索引。 |
add_documents | index_name, documents, upsert? | 在索引中添加或更新文档。 |
delete_documents | index_name, doc_ids | 按ID删除特定文档。 |
get_documents | index_name, doc_ids? | 检索文档内容和元数据。 |
delete_index | index_name | 永久删除索引。 |
💻 Claude桌面配置
将此添加到您的Claude Desktop配置文件中：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"moss": {
"command": "python",
"args": ["/absolute/path/to/moss_server.py"],
"env": {
"MOSS_PROJECT_ID": "your_project_id",
"MOSS_PROJECT_KEY": "your_project_key"
}
}
}
}\[！重要\] 替换 /absolute/path/to/moss_server.py 使用机器上的实际路径。📖 用法示例
配置后，您可以让Claude管理您的索引：
用户提示：
“创建一个名为“kb-docs”的新Moss索引，并添加这些文档，详细说明我们的API指南：\[docs…\]”
用户提示：
“列出我当前的所有Moss索引，并告诉我每个索引中有多少文档。”
⚡ 语义查询注意事项
Moss REST API处理 索引管理 （CRUD操作）。对于 高速语义搜索查询 （低于10ms），使用 Moss Python SDK 直接在您的应用程序代码中。
from moss import MossClient
client = MossClient(project_id="...", project_key="...")
results = client.query(index_name="kb-docs", text="What is the rate limit?")🔗 资源
______________________________________________________________________