AI导哈

语义搜索索引管理服务器

Moss MCP Server是一个基于Model Context Protocol（MCP）的服务器，用于管理高性能语义搜索索引，支持创建、列表和删除向量索引，以及文档的添加、更新和移除，适用于AI助手集成和快速语义搜索场景。

  • by CoderOMaster
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 CoderOMaster/moss-mcp

使用说明

Moss MCP服务器

一种模型上下文协议（MCP）服务器，用于使用 Moss REST API.

✨ 主要特点

  • 语义索引管理：创建、列出和删除针对低于10ms性能优化的向量索引。
  • 高效的文档处理：轻松添加、更新和删除文档。
  • 基于REST的管理：直接从您的AI助手完全控制您的Moss项目。
  • 无缝集成Claude：已为Claude Desktop预配置。

🚀 入门指南

1.先决条件

2.安装

pip install fastmcp httpx inferedge-moss python-dotenv

3.设置凭据

  1. 去 莫斯门户.
  2. 创建或选择一个项目。
  3. 获取您的 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?")

🔗 资源

相关 MCP