Doctah MCP

🚀 Doctah-MCP

Doctah-MCP 服務器藉助模型上下文協議（MCP），在 AI 助手和 PRTS.wiki 的明日方舟知識庫之間搭建了一座橋樑。它能讓 AI 模型以編程方式搜索幹員和敵人信息，並訪問其具體內容。

🚀 快速開始

從源代碼安裝

git clone https://github.com/TonybotNi/Doctah-MCP.git
cd doctah-mcp
pip install -e .

驗證安裝：

# 測試全局命令是否可用
doctah-mcp --help

# 或者使用 Python 模塊進行測試
python -m doctah_mcp.server --help

若用於開發：

# 克隆並設置開發環境
git clone https://github.com/TonybotNi/Doctah-MCP.git
cd doctah-mcp

# 安裝帶有測試依賴的包
pip install -e ".[dev]"

🔌 MCP 集成

為你的 MCP 客戶端配置文件選擇以下配置方法之一： 方法 1：使用全局命令（推薦）

{
    "mcpServers": {
        "doctah-mcp": {
            "command": "doctah-mcp",
            // 或者使用完整路徑: "/full/path/to/doctah-mcp"
            "args": []
        }
    }
}

💡 若未找到 doctah-mcp 命令，請使用方法 3 並指定 Python 可執行文件的完整路徑。

方法 2：使用 Python 模塊

{
    "mcpServers": {
        "doctah-mcp": {
            "command": "python",
            "args": ["-m", "doctah_mcp.server"]
        }
    }
}

方法 3：使用完整路徑（最可靠）

{
    "mcpServers": {
        "doctah-mcp": {
            "command": "/full/path/to/python",
            "args": ["-m", "doctah_mcp.server"],
            "cwd": "/path/to/doctah-mcp-folder"
        }
    }
}

💡 注意：cwd 是工作目錄，僅在方法 3 中需要，指向你下載的 doctah-mcp 項目文件夾。

✨ 主要特性

• 🎯 幹員搜索：查詢詳細的幹員信息，包括技能、天賦和屬性。
• ⚔️ 敵人情報：獲取包含等級進展的全面敵人數據。
• 📋 列表搜索：通過模糊搜索功能查找幹員和敵人。
• 🔍 內容驗證：智能內容驗證，區分幹員和敵人。
• 🤖 對 AI 友好：輸出結構一致、簡潔的 Markdown 內容。

💻 使用示例

基礎用法

服務器提供了四個主要工具：

1. 幹員搜索

搜索詳細的幹員信息：

result = await call_tool("search_operator_mcp", {
    "name": "Amiya",
    "sections": "skills,talents"
})

2. 敵人搜索

獲取全面的敵人數據：

result = await call_tool("search_enemy_mcp", {
    "name": "Originium Slug",
    "sections": "level0,level1"
})

3. 列出幹員

查找匹配模式的幹員：

result = await call_tool("list_operators_mcp", {
    "name": "guard"
})

4. 列出敵人

查找匹配模式的敵人：

result = await call_tool("list_enemies_mcp", {
    "name": "drone"
})

📋 客戶端配置

Claude Desktop

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json 推薦配置（最簡單）：

{
  "mcpServers": {
    "doctah-mcp": {
      "command": "doctah-mcp",
      "args": []
    }
  }
}

備用配置（若上述配置不起作用）：

{
  "mcpServers": {
    "doctah-mcp": {
      "command": "/full/path/to/python",
      "args": ["-m", "doctah_mcp.server"],
      "cwd": "/path/to/doctah-mcp-folder"
    }
  }
}

Cherry Studio

1. 打開 Cherry Studio → 設置 → MCP 服務器 → 添加。
2. 選擇類型：STDIO。
3. 簡單配置：
   • 命令：doctah-mcp
   • 參數：[]
4. 備用配置（若上述配置不起作用）：
   • 命令：/full/path/to/python
   • 參數：["-m", "doctah_mcp.server"]
   • 工作目錄：/path/to/doctah-mcp-folder

🔧 配置

通過環境變量進行配置：

🧪 測試

運行測試套件：

python -m pytest

📄 許可證

本項目採用 MIT 許可證發佈。詳情請參閱 LICENSE 文件。

📚 詳細文檔

需要更詳細的配置和故障排除指南？請查看：

• Claude Desktop 詳細設置
• Cherry Studio 詳細設置