返回 MCP 目录
public公开dns本地运行

mcp-server-python

Inkeep MCP Server是一个基于Python的项目,通过集成Inkeep的RAG技术,为Claude Desktop提供产品文档检索服务。

article

README

🚀 mcp-server-python

mcp-server-python 是一个由 Inkeep 驱动的 RAG MCP Server,可帮助你更好地管理和使用文档与产品内容。

🚀 快速开始

✨ 主要特性

  • 由 Inkeep 驱动,提供强大的 RAG 能力。
  • 借助 uv 进行 Python 项目管理,方便快捷。

📦 安装指南

依赖项

  • 需要一个 Inkeep 账户,用于管理并提供 RAG。
  • uv Python 项目管理器。

本地设置

git clone https://github.com/inkeep/mcp-server-python.git
cd mcp-server-python
uv venv
uv pip install -r pyproject.toml

⚠️ 重要提示 注意项目的完整路径,后续步骤中将引用为<YOUR_INKEEP_MCP_SERVER_ABSOLUTE_PATH>

💻 使用示例

获取 API 密钥

  1. 登录Inkeep 仪表盘
  2. 进入项目部分并选择你的项目。
  3. 打开集成标签。
  4. 点击创建集成,然后从选项中选择API
  5. 为新的 API 集成输入一个名称。
  6. 点击创建
  7. 出现的生成API 密钥可用于认证 API 请求。

我们将这个 API 密钥称为<YOUR_INKEEP_API_KEY>用于后续步骤。

添加到你的 MCP 客户端

按照指南设置 Claude Desktop。

在你的claude_desktop_config.json文件中,向mcpServers添加以下内容:

{
    "mcpServers": {
        "inkeep-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "<YOUR_INKEEP_MCP_SERVER_ABSOLUTE_PATH>",
                "run",
                "-m",
                "inkeep_mcp_server"
            ],
            "env": {
                "INKEEP_API_BASE_URL": "https://api.inkeep.com/v1",  
                "INKEEP_API_KEY": "<YOUR_INKEEP_API_KEY>",  
                "INKEEP_API_MODEL": "inkeep-rag",  
                "INKEEP_MCP_TOOL_NAME": "search-product-content",  
                "INKEEP_MCP_TOOL_DESCRIPTION": "检索 Inkeep 的产品文档。查询应以关于 Inkeep 的对话形式提出。"  
            }
        },
    }
}

💡 使用建议 你可能需要在命令字段中提供uv可执行文件的完整路径。你可以在 MacOS/Linux 上运行which uv或 Windows 上的where uv来获取此路径。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端