AI导哈

知识库交互服务器

Senso API MCP服务器是一个模型上下文协议实现，允许Claude通过Claude Desktop与Senso知识库进行交互，包括添加、搜索和生成内容。

  • by AI-Template-SDK
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ai-template-sdk/api-mcp-server

使用说明

Senso API MCP 服务器

Senso API的模型上下文协议（MCP）服务器实现，允许Claude通过Claude Desktop与您的Senso知识库进行交互。

此服务器使Claude能够：

  • 将原始内容添加到您的知识库中
  • 搜索现有内容
  • 根据您的知识库生成新内容

先决条件

  • Python 3.12或更高版本
  • 紫外线 -快速Python包安装程序和解析器
  • Claude桌面应用程序

安装

  1. 克隆此存储库：

    git clone git@github.com:AI-Template-SDK/api-mcp-server.git
cd api-mcp-server

  2. 使用创建虚拟环境并安装依赖项 uv:

    # Create and activate virtual environment
uv venv

# On macOS/Linux
source .venv/bin/activate

# On Windows
.venv\Scripts\activate

# Install dependencies from pyproject.toml
uv pip install -e .

配置

API密钥

服务器使用Senso API密钥进行身份验证。您需要在中编辑API密钥 server.py 文件：

  1. 打开 server.py 在文本编辑器中
  2. 找到线路： API_KEY = "tgr_YOUR_API_KEY"
  3. 将其替换为您自己的Senso API密钥

Claude桌面配置

要将此MCP服务器与Claude Desktop一起使用，您需要将其添加到Claude的配置中：

  1. 查找或创建Claude Desktop配置文件：

    • 在 macOS 上：

      mkdir -p ~/Library/Application\ Support/Claude
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

    • 在Windows上：

      if (-not (Test-Path $env:AppData\Claude)) { mkdir $env:AppData\Claude }
code $env:AppData\Claude\claude_desktop_config.json

  2. 将Senso MCP服务器配置添加到文件中：

    {
    "mcpServers": {
        "senso": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/api-mcp-server",
                "run",
                "server.py"
            ]
        }
    }
}

    对于Windows，请使用适当的路径格式：

    {
    "mcpServers": {
        "senso": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\api-mcp-server",
                "run",
                "server.py"
            ]
        }
    }
}

    ⚠️ 重要：将路径替换为克隆存储库的绝对路径。

  3. 重新启动Claude Desktop以应用更改。

与Claude一起使用MCP工具

设置服务器并配置Claude Desktop后，您可以通过自然语言交互使用这些工具：

添加内容

问克劳德：

Please add this information to my knowledge base:
Title: Introduction to MCP
Summary: A brief overview of the Model Context Protocol
Text: The Model Context Protocol (MCP) allows large language models to interact with external tools and data sources. It enables Claude to perform actions like retrieving information, accessing files, and executing operations through a standardized interface.

搜索内容

问克劳德：

Can you search my knowledge base for information about "MCP"?

生成内容

问克劳德：

Using my knowledge base, please generate a tutorial about AI assistants and save it to my knowledge base.

故障排除

检查日志

如果您遇到问题，请查看Claude Desktop日志：

  • macOS： ~/Library/Logs/Claude/mcp-server-senso.log
  • 窗户： %APPDATA%\Claude\Logs\mcp-server-senso.log

常见问题

  • Claude中没有显示工具：确保Claude Desktop已重新启动，配置文件格式正确。
  • API关键问题：如果您需要更新API密钥，请直接在 server.py 文件。
  • 路径问题：确保在Claude配置中使用了绝对路径，而不是相对路径。

更新uv

如果您遇到以下问题 uv，确保您拥有最新版本：

curl -LsSf https://astral.sh/uv/install.sh | sh

贡献

欢迎投稿！请随时提交拉取请求。

许可证

MIT许可证

专为集成而设计 感觉 API

相关 MCP