Doctah-MCP

<div align="center"> <img src="./assets/images/doctah-mcp-logo.png" alt="Doctah-MCP Logo" width="150" height="150"> # Doctah-MCP [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io/) **🌍 Language / 语言选择:** [🇺🇸 English](README.md) | [🇨🇳 中文](README_zh.md) </div> > 🎯 Enable AI assistants to search and access Arknights game data through a simple MCP interface. The Doctah-MCP Server provides a bridge between AI assistants and PRTS.wiki's Arknights repository through the Model Context Protocol (MCP). It allows AI models to search for operators and enemies and access their content in a programmatic way. ## ✨ Core Features * 🎯 **Operator Search**: Query detailed operator information including skills, talents, and attributes * ⚔️ **Enemy Intelligence**: Access comprehensive enemy data with level progression * 📋 **List Search**: Find operators and enemies with fuzzy search functionality * 🔍 **Content Verification**: Smart content validation to distinguish operators from enemies * 🤖 **AI-Friendly**: Clean Markdown output with consistent structure ## 🚀 Quick Start ### Install from Source ```bash git clone https://github.com/TonybotNi/Doctah-MCP.git cd doctah-mcp pip install -e . ``` **Verify installation:** ```bash # Test if global command works doctah-mcp --help # Or test with Python module python -m doctah_mcp.server --help ``` For development: ```bash # Clone and set up development environment git clone https://github.com/TonybotNi/Doctah-MCP.git cd doctah-mcp # Install with test dependencies pip install -e ".[dev]" ``` ### 🔌 MCP Integration Choose one of the following configuration methods for your MCP client config file: **Method 1: Using global command (recommended)** ```json { "mcpServers": { "doctah-mcp": { "command": "doctah-mcp", // Or use full path: "/full/path/to/doctah-mcp" "args": [] } } } ``` > 💡 If `doctah-mcp` command is not found, use Method 3 with full path to python executable **Method 2: Using Python module** ```json { "mcpServers": { "doctah-mcp": { "command": "python", "args": ["-m", "doctah_mcp.server"] } } } ``` **Method 3: Using full path (most reliable)** ```json { "mcpServers": { "doctah-mcp": { "command": "/full/path/to/python", "args": ["-m", "doctah_mcp.server"], "cwd": "/path/to/doctah-mcp-folder" } } } ``` > 💡 **Note**: `cwd` is the working directory, only needed in method 3, pointing to your downloaded doctah-mcp project folder ## 💡 Available Tools The server provides four main tools: ### 1. Operator Search Search for detailed operator information: ```python result = await call_tool("search_operator_mcp", { "name": "Amiya", "sections": "skills,talents" }) ``` ### 2. Enemy Search Get comprehensive enemy data: ```python result = await call_tool("search_enemy_mcp", { "name": "Originium Slug", "sections": "level0,level1" }) ``` ### 3. List Operators Find operators matching a pattern: ```python result = await call_tool("list_operators_mcp", { "name": "guard" }) ``` ### 4. List Enemies Find enemies matching a pattern: ```python result = await call_tool("list_enemies_mcp", { "name": "drone" }) ``` ## 📁 Client Configuration ### Claude Desktop Configuration file locations: - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` - **Linux**: `~/.config/Claude/claude_desktop_config.json` **Recommended configuration (simplest):** ```json { "mcpServers": { "doctah-mcp": { "command": "doctah-mcp", "args": [] } } } ``` **Fallback configuration (if above doesn't work):** ```json { "mcpServers": { "doctah-mcp": { "command": "/full/path/to/python", "args": ["-m", "doctah_mcp.server"], "cwd": "/path/to/doctah-mcp-folder" } } } ``` ### Cherry Studio 1. Open Cherry Studio → Settings → MCP Servers → Add 2. Select Type: STDIO 3. **Simple configuration**: - **Command**: `doctah-mcp` - **Args**: `[]` 4. **Fallback configuration** (if above doesn't work): - **Command**: `/full/path/to/python` - **Args**: `["-m", "doctah_mcp.server"]` - **Cwd**: `/path/to/doctah-mcp-folder` ## ⚙️ Configuration Configure through environment variables: | Variable | Purpose | Default | |----------|---------|---------| | LOG_LEVEL | Logging level | INFO | ## 🧪 Testing Run the test suite: ```bash python -m pytest ``` ## 📄 License Released under the MIT License. See the [LICENSE](LICENSE) file for details. ## 📖 Detailed Setup Guides Need more detailed configuration and troubleshooting? Check out: - [Claude Desktop Detailed Setup](docs/setup/claude_desktop.md) - [Cherry Studio Detailed Setup](docs/setup/cherry_studio.md) --- <div align="center"> Made with ❤️ for Arknights community ## GitHub Star History [](https://star-history.com/#tonybotni/doctah-mcp&Date) </div>