Senso API MCP Server

Senso API MCP 服务

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

此服务可让 Claude：

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

前置条件

• Python 3.12 或更高版本
• uv —— 快速的 Python 包安装器和解析器
• Claude Desktop 应用程序

安装

1. 克隆此仓库：

   git clone [email protected]: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 密钥进行身份验证。您需要在 server.py 文件中编辑 API 密钥：

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

Claude Desktop 配置

若要在 Claude Desktop 中使用此 MCP 服务，您需要将其添加到 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 后，您可以通过自然语言交互使用这些工具：

添加内容

向 Claude 提问：

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.

搜索内容

向 Claude 提问：

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

生成内容

向 Claude 提问：

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
• Windows：%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

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证

---

为与 Senso API 集成而打造