guru-pk-mcp


Nameguru-pk-mcp JSON
Version 1.2.2 PyPI version JSON
download
home_pageNone
SummaryMCP server enabling AI expert debates - Dynamic expert generation for personalized multi-round philosophical discussions on any topic
upload_time2025-07-13 17:16:19
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT License Copyright (c) 2025 MitsudoAI Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords ai claude-desktop cursor dynamic-experts expert-debate intelligent-generation mcp model-context-protocol multi-round-debate philosophy uvx
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # Guru-PK MCP 智能专家辩论系统

基于本地MCP（Model Context Protocol）的AI专家辩论系统，采用**动态专家生成架构**，根据问题而智能的创建最适合的专家组合进行多轮智慧碰撞。

## ✨ 核心特色

- 🏭 **动态专家生成** - 完全问题驱动，每次生成专属专家组合
- 🌟 **无限专家池** - 突破固定专家限制，支持任意领域的专家生成
- 🔄 **多轮PK流程** - 独立思考 → 交叉辩论 → 最终立场 → 智慧综合  
- 🎨 **塔夫特风格信息图** - 将专家辩论转化为严格遵循数据可视化大师爱德华·塔夫特设计原则的单页动态信息图
- 🤖 **智能分工架构** - MCP Host端LLM负责智能分析，MCP Server端提供流程指导

## 🚀 快速安装

### 1. 安装依赖

**方式一：使用安装脚本（推荐）**

**macOS/Linux:**

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

**Windows:**

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

**方式二：使用 pip 安装（适用于所有平台）**

```bash
pip install uv
```

**方式三：下载安装包**

从 [UV Releases](https://github.com/astral-sh/uv/releases) 页面下载对应平台的安装包

### 2. 配置MCP客户端

**推荐方式：从PyPI安装**

```json
{
  "mcpServers": {
    "guru-pk": {
      "command": "uvx",
      "args": ["--from", "guru-pk-mcp", "guru-pk-mcp-server"],
      "env": {
        "DATA_DIR": "~/.guru-pk-data"  // macOS/Linux: ~/目录, Windows: %USERPROFILE%目录
      }
    }
  }
}
```

> **更新说明**:
>
> - 当需要更新`guru-pk-mcp`到最新版本时，请执行命令：
>
>   ```bash
>   uvx pip install --upgrade guru-pk-mcp
>   ```
>
> - 此命令会从PyPI获取并安装最新发布的版本
> - 如果遇到缓存问题，可以强制刷新：
>
>   ```bash
>   uvx --refresh-package guru-pk-mcp --from guru-pk-mcp python -c "print('✅ UVX缓存已刷新')"
>   ```
>
> **注意**:
>
> - macOS用户可能需要使用完整路径：`/Users/{用户名}/.local/bin/uvx`
> - Windows用户：`~`会自动解析为用户主目录（如 `C:\Users\{用户名}`），无需手动修改

**开发方式：从源码安装**

```json
{
  "mcpServers": {
    "guru-pk": {
      "command": "uvx", 
      "args": ["--from", "/path/to/guru-pk-mcp", "guru-pk-mcp-server"],
      "env": {
        "DATA_DIR": "~/.guru-pk-data"  // macOS/Linux: ~/目录, Windows: %USERPROFILE%目录
      }
    }
  }
}
```

> **本地开发说明**:
>
> - 对于本地开发场景，如需刷新uvx缓存，请使用`make refresh-uvx`
> - 此命令强制UVX重新安装本地包，确保使用最新的代码更改

## 使用入门

重启MCP客户端，输入 `guru_pk_help` 获取帮助，或直接提问开始专家辩论！

```javascript
// 1. 自然语言提问（最推荐的使用方式）
生成AI的领域，有没有特别适合个人创业的方向？请三个专家PK

// 2. 智能生成候选专家（系统自动执行）
start_pk_session: 生成AI的领域，有没有特别适合个人创业的方向？

// 3. 智能生成候选专家（用户对期待的专家范围进行限定）
start_pk_session: 生成AI的领域，有没有特别适合个人创业的方向？ 找两个AI领域的大牛和一个知名的个人创业家来辩论
```

### 💡 使用提示

**启动辩论**：

- 🤖 **`start_pk_session:直接提问`** - 默认高效批处理模式（推荐）
- 🔄 **`start_stepwise_pk_session:直接提问`** - 传统逐步对话模式

**工具功能**：

- 📋 `guru_pk_help` - 获取系统介绍和详细帮助
- 📄 `export_session` - 导出会话为Markdown文件
- 🎨 `export_session_as_infographic` - 导出会话为塔夫特风格单页动态信息图
- 📄 `export_enhanced_session` - 导出增强分析报告
- 🌍 `set_language` - 设置专家回复语言

### 📱 兼容性

支持所有MCP兼容应用：Claude Desktop、Cursor、TRAE、DeepChat、Cherry Studio等

### 🎯 推荐配置

**最推荐的MCP Host**：

- 💰 **按用户请求计算的订阅制MCP Host** - 如Cursor和海外版Trae
- 🌟 **优势**：
  - 成本优势显著：按用户请求计算的订阅制收费，而非API调用次数或token收费
  - Claude模型对MCP支持最佳，具有优秀的指令遵循能力

### ⚠️ 不推荐配置

- 🚫 **Trae国内版** - 内置的国内模型存在敏感词审查问题，可能导致专家辩论过程中断，影响使用体验

## 🛠️ 技术架构

**智能分工原则**：

- 🧠 **MCP Host端 LLM**：负责复杂的语义分析和智能生成
- 🔧 **MCP Server端**：提供简洁的流程控制和数据管理

### 动态专家生成流程

```mermaid
flowchart TD
    A[🤔 提出问题] --> B[🧠 智能分析]
    B --> C[👥 生成候选]
    C --> D[🚀 开始辩论]
    
    A1[直接向系统提问任何话题]
    B1[MCP Host端LLM深度分析问题特征]
    C1[动态创建3位最相关的专家]
    D1[启动多轮PK流程]
    
    A -.-> A1
    B -.-> B1
    C -.-> C1
    D -.-> D1
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#fff3e0
```

### 🔄 辩论流程

**两种辩论模式**：

🚀 **批处理模式** (`start_pk_session`) - **默认推荐**

- ⚡ 高效率：一轮生成所有专家回答，节省约60%时间
- 🎯 适用场景：快速获取多角度分析，高效决策支持

🔄 **逐步模式** (`start_stepwise_pk_session`) - 传统体验  

- 🎭 互动性：逐个专家发言，实时调整和深入探讨
- 🎯 适用场景：深度思辨，享受完整辩论过程

**4轮辩论流程**：

```mermaid
flowchart TD
    A[🤔 独立思考] --> B[⚔️ 交叉辩论]
    B --> C[🎯 最终立场]
    C --> D[🧠 智慧综合]
    
    A1[每位专家独立分析问题]
    B1[专家间互相质疑和借鉴]
    C1[形成各自完善的方案]
    D1[融合各方观点的终极答案]
    
    A -.-> A1
    B -.-> B1
    C -.-> C1
    D -.-> D1
    
    B --> B2[多轮交互]
    B2 --> B
    
    style A fill:#e3f2fd
    style B fill:#fce4ec
    style C fill:#e8f5e8
    style D fill:#fff8e1
    style B2 fill:#f3e5f5
```

## 💭 设计理念

### 灵感来源

本项目初期的专家系统受到 [人生教练团Agent](https://mp.weixin.qq.com/s/QGNzRRo7U3Y2fmvOXNJvyw) 的启发，将内置专家的多角色PK的创新思路通过本地MCP的方式实现。

### 技术方案对比

**🔧 Agent框架开发**

- ✅ 功能强大，可集成多个LLM API
- ✅ 前端交互灵活，控制强劲
- ❌ 开发复杂度高，API调用成本高昂

**☁️ 第三方文档服务远程MCP方案(飞书MCP)**  

- ✅ 部署简单，利用现有生态
- ❌ 依赖第三方服务，定制化程度有限

**🏠 本地MCP方案（本项目）**

- ✅ 与订阅制Chat APP结合，无API费用
- ✅ 数据本地化，隐私保护
- ✅ 开源可定制，技术独立
- ✅ **智能分工架构** - 充分利用MCP Host端LLM智能
- ✅ **动态专家生成** - 突破固定专家池限制
- ❌ 依赖MCP客户端实现

本项目最新的设计，通过完全的动态专家生成，实现了从固定专家库到智能专家工厂的根本性突破。
借助于MCP Host端大语言模型的智能，MCP服务器端(本项目)专注流程控制，降低维护成本，实现智能与简洁的最佳平衡。

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "guru-pk-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "ai, claude-desktop, cursor, dynamic-experts, expert-debate, intelligent-generation, mcp, model-context-protocol, multi-round-debate, philosophy, uvx",
    "author": null,
    "author_email": "Ryu <ryu@mitsudo.tech>",
    "download_url": "https://files.pythonhosted.org/packages/70/d7/181ef55af23cfaafe1641701dbd61f7f76fcc1281e8a74329e9e7401d522/guru_pk_mcp-1.2.2.tar.gz",
    "platform": null,
    "description": "# Guru-PK MCP \u667a\u80fd\u4e13\u5bb6\u8fa9\u8bba\u7cfb\u7edf\n\n\u57fa\u4e8e\u672c\u5730MCP\uff08Model Context Protocol\uff09\u7684AI\u4e13\u5bb6\u8fa9\u8bba\u7cfb\u7edf\uff0c\u91c7\u7528**\u52a8\u6001\u4e13\u5bb6\u751f\u6210\u67b6\u6784**\uff0c\u6839\u636e\u95ee\u9898\u800c\u667a\u80fd\u7684\u521b\u5efa\u6700\u9002\u5408\u7684\u4e13\u5bb6\u7ec4\u5408\u8fdb\u884c\u591a\u8f6e\u667a\u6167\u78b0\u649e\u3002\n\n## \u2728 \u6838\u5fc3\u7279\u8272\n\n- \ud83c\udfed **\u52a8\u6001\u4e13\u5bb6\u751f\u6210** - \u5b8c\u5168\u95ee\u9898\u9a71\u52a8\uff0c\u6bcf\u6b21\u751f\u6210\u4e13\u5c5e\u4e13\u5bb6\u7ec4\u5408\n- \ud83c\udf1f **\u65e0\u9650\u4e13\u5bb6\u6c60** - \u7a81\u7834\u56fa\u5b9a\u4e13\u5bb6\u9650\u5236\uff0c\u652f\u6301\u4efb\u610f\u9886\u57df\u7684\u4e13\u5bb6\u751f\u6210\n- \ud83d\udd04 **\u591a\u8f6ePK\u6d41\u7a0b** - \u72ec\u7acb\u601d\u8003 \u2192 \u4ea4\u53c9\u8fa9\u8bba \u2192 \u6700\u7ec8\u7acb\u573a \u2192 \u667a\u6167\u7efc\u5408  \n- \ud83c\udfa8 **\u5854\u592b\u7279\u98ce\u683c\u4fe1\u606f\u56fe** - \u5c06\u4e13\u5bb6\u8fa9\u8bba\u8f6c\u5316\u4e3a\u4e25\u683c\u9075\u5faa\u6570\u636e\u53ef\u89c6\u5316\u5927\u5e08\u7231\u5fb7\u534e\u00b7\u5854\u592b\u7279\u8bbe\u8ba1\u539f\u5219\u7684\u5355\u9875\u52a8\u6001\u4fe1\u606f\u56fe\n- \ud83e\udd16 **\u667a\u80fd\u5206\u5de5\u67b6\u6784** - MCP Host\u7aefLLM\u8d1f\u8d23\u667a\u80fd\u5206\u6790\uff0cMCP Server\u7aef\u63d0\u4f9b\u6d41\u7a0b\u6307\u5bfc\n\n## \ud83d\ude80 \u5feb\u901f\u5b89\u88c5\n\n### 1. \u5b89\u88c5\u4f9d\u8d56\n\n**\u65b9\u5f0f\u4e00\uff1a\u4f7f\u7528\u5b89\u88c5\u811a\u672c\uff08\u63a8\u8350\uff09**\n\n**macOS/Linux:**\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**Windows:**\n\n```powershell\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n**\u65b9\u5f0f\u4e8c\uff1a\u4f7f\u7528 pip \u5b89\u88c5\uff08\u9002\u7528\u4e8e\u6240\u6709\u5e73\u53f0\uff09**\n\n```bash\npip install uv\n```\n\n**\u65b9\u5f0f\u4e09\uff1a\u4e0b\u8f7d\u5b89\u88c5\u5305**\n\n\u4ece [UV Releases](https://github.com/astral-sh/uv/releases) \u9875\u9762\u4e0b\u8f7d\u5bf9\u5e94\u5e73\u53f0\u7684\u5b89\u88c5\u5305\n\n### 2. \u914d\u7f6eMCP\u5ba2\u6237\u7aef\n\n**\u63a8\u8350\u65b9\u5f0f\uff1a\u4ecePyPI\u5b89\u88c5**\n\n```json\n{\n  \"mcpServers\": {\n    \"guru-pk\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"guru-pk-mcp\", \"guru-pk-mcp-server\"],\n      \"env\": {\n        \"DATA_DIR\": \"~/.guru-pk-data\"  // macOS/Linux: ~/\u76ee\u5f55, Windows: %USERPROFILE%\u76ee\u5f55\n      }\n    }\n  }\n}\n```\n\n> **\u66f4\u65b0\u8bf4\u660e**:\n>\n> - \u5f53\u9700\u8981\u66f4\u65b0`guru-pk-mcp`\u5230\u6700\u65b0\u7248\u672c\u65f6\uff0c\u8bf7\u6267\u884c\u547d\u4ee4\uff1a\n>\n>   ```bash\n>   uvx pip install --upgrade guru-pk-mcp\n>   ```\n>\n> - \u6b64\u547d\u4ee4\u4f1a\u4ecePyPI\u83b7\u53d6\u5e76\u5b89\u88c5\u6700\u65b0\u53d1\u5e03\u7684\u7248\u672c\n> - \u5982\u679c\u9047\u5230\u7f13\u5b58\u95ee\u9898\uff0c\u53ef\u4ee5\u5f3a\u5236\u5237\u65b0\uff1a\n>\n>   ```bash\n>   uvx --refresh-package guru-pk-mcp --from guru-pk-mcp python -c \"print('\u2705 UVX\u7f13\u5b58\u5df2\u5237\u65b0')\"\n>   ```\n>\n> **\u6ce8\u610f**:\n>\n> - macOS\u7528\u6237\u53ef\u80fd\u9700\u8981\u4f7f\u7528\u5b8c\u6574\u8def\u5f84\uff1a`/Users/{\u7528\u6237\u540d}/.local/bin/uvx`\n> - Windows\u7528\u6237\uff1a`~`\u4f1a\u81ea\u52a8\u89e3\u6790\u4e3a\u7528\u6237\u4e3b\u76ee\u5f55\uff08\u5982 `C:\\Users\\{\u7528\u6237\u540d}`\uff09\uff0c\u65e0\u9700\u624b\u52a8\u4fee\u6539\n\n**\u5f00\u53d1\u65b9\u5f0f\uff1a\u4ece\u6e90\u7801\u5b89\u88c5**\n\n```json\n{\n  \"mcpServers\": {\n    \"guru-pk\": {\n      \"command\": \"uvx\", \n      \"args\": [\"--from\", \"/path/to/guru-pk-mcp\", \"guru-pk-mcp-server\"],\n      \"env\": {\n        \"DATA_DIR\": \"~/.guru-pk-data\"  // macOS/Linux: ~/\u76ee\u5f55, Windows: %USERPROFILE%\u76ee\u5f55\n      }\n    }\n  }\n}\n```\n\n> **\u672c\u5730\u5f00\u53d1\u8bf4\u660e**:\n>\n> - \u5bf9\u4e8e\u672c\u5730\u5f00\u53d1\u573a\u666f\uff0c\u5982\u9700\u5237\u65b0uvx\u7f13\u5b58\uff0c\u8bf7\u4f7f\u7528`make refresh-uvx`\n> - \u6b64\u547d\u4ee4\u5f3a\u5236UVX\u91cd\u65b0\u5b89\u88c5\u672c\u5730\u5305\uff0c\u786e\u4fdd\u4f7f\u7528\u6700\u65b0\u7684\u4ee3\u7801\u66f4\u6539\n\n## \u4f7f\u7528\u5165\u95e8\n\n\u91cd\u542fMCP\u5ba2\u6237\u7aef\uff0c\u8f93\u5165 `guru_pk_help` \u83b7\u53d6\u5e2e\u52a9\uff0c\u6216\u76f4\u63a5\u63d0\u95ee\u5f00\u59cb\u4e13\u5bb6\u8fa9\u8bba\uff01\n\n```javascript\n// 1. \u81ea\u7136\u8bed\u8a00\u63d0\u95ee\uff08\u6700\u63a8\u8350\u7684\u4f7f\u7528\u65b9\u5f0f\uff09\n\u751f\u6210AI\u7684\u9886\u57df\uff0c\u6709\u6ca1\u6709\u7279\u522b\u9002\u5408\u4e2a\u4eba\u521b\u4e1a\u7684\u65b9\u5411\uff1f\u8bf7\u4e09\u4e2a\u4e13\u5bb6PK\n\n// 2. \u667a\u80fd\u751f\u6210\u5019\u9009\u4e13\u5bb6\uff08\u7cfb\u7edf\u81ea\u52a8\u6267\u884c\uff09\nstart_pk_session: \u751f\u6210AI\u7684\u9886\u57df\uff0c\u6709\u6ca1\u6709\u7279\u522b\u9002\u5408\u4e2a\u4eba\u521b\u4e1a\u7684\u65b9\u5411\uff1f\n\n// 3. \u667a\u80fd\u751f\u6210\u5019\u9009\u4e13\u5bb6\uff08\u7528\u6237\u5bf9\u671f\u5f85\u7684\u4e13\u5bb6\u8303\u56f4\u8fdb\u884c\u9650\u5b9a\uff09\nstart_pk_session: \u751f\u6210AI\u7684\u9886\u57df\uff0c\u6709\u6ca1\u6709\u7279\u522b\u9002\u5408\u4e2a\u4eba\u521b\u4e1a\u7684\u65b9\u5411\uff1f \u627e\u4e24\u4e2aAI\u9886\u57df\u7684\u5927\u725b\u548c\u4e00\u4e2a\u77e5\u540d\u7684\u4e2a\u4eba\u521b\u4e1a\u5bb6\u6765\u8fa9\u8bba\n```\n\n### \ud83d\udca1 \u4f7f\u7528\u63d0\u793a\n\n**\u542f\u52a8\u8fa9\u8bba**\uff1a\n\n- \ud83e\udd16 **`start_pk_session:\u76f4\u63a5\u63d0\u95ee`** - \u9ed8\u8ba4\u9ad8\u6548\u6279\u5904\u7406\u6a21\u5f0f\uff08\u63a8\u8350\uff09\n- \ud83d\udd04 **`start_stepwise_pk_session:\u76f4\u63a5\u63d0\u95ee`** - \u4f20\u7edf\u9010\u6b65\u5bf9\u8bdd\u6a21\u5f0f\n\n**\u5de5\u5177\u529f\u80fd**\uff1a\n\n- \ud83d\udccb `guru_pk_help` - \u83b7\u53d6\u7cfb\u7edf\u4ecb\u7ecd\u548c\u8be6\u7ec6\u5e2e\u52a9\n- \ud83d\udcc4 `export_session` - \u5bfc\u51fa\u4f1a\u8bdd\u4e3aMarkdown\u6587\u4ef6\n- \ud83c\udfa8 `export_session_as_infographic` - \u5bfc\u51fa\u4f1a\u8bdd\u4e3a\u5854\u592b\u7279\u98ce\u683c\u5355\u9875\u52a8\u6001\u4fe1\u606f\u56fe\n- \ud83d\udcc4 `export_enhanced_session` - \u5bfc\u51fa\u589e\u5f3a\u5206\u6790\u62a5\u544a\n- \ud83c\udf0d `set_language` - \u8bbe\u7f6e\u4e13\u5bb6\u56de\u590d\u8bed\u8a00\n\n### \ud83d\udcf1 \u517c\u5bb9\u6027\n\n\u652f\u6301\u6240\u6709MCP\u517c\u5bb9\u5e94\u7528\uff1aClaude Desktop\u3001Cursor\u3001TRAE\u3001DeepChat\u3001Cherry Studio\u7b49\n\n### \ud83c\udfaf \u63a8\u8350\u914d\u7f6e\n\n**\u6700\u63a8\u8350\u7684MCP Host**\uff1a\n\n- \ud83d\udcb0 **\u6309\u7528\u6237\u8bf7\u6c42\u8ba1\u7b97\u7684\u8ba2\u9605\u5236MCP Host** - \u5982Cursor\u548c\u6d77\u5916\u7248Trae\n- \ud83c\udf1f **\u4f18\u52bf**\uff1a\n  - \u6210\u672c\u4f18\u52bf\u663e\u8457\uff1a\u6309\u7528\u6237\u8bf7\u6c42\u8ba1\u7b97\u7684\u8ba2\u9605\u5236\u6536\u8d39\uff0c\u800c\u975eAPI\u8c03\u7528\u6b21\u6570\u6216token\u6536\u8d39\n  - Claude\u6a21\u578b\u5bf9MCP\u652f\u6301\u6700\u4f73\uff0c\u5177\u6709\u4f18\u79c0\u7684\u6307\u4ee4\u9075\u5faa\u80fd\u529b\n\n### \u26a0\ufe0f \u4e0d\u63a8\u8350\u914d\u7f6e\n\n- \ud83d\udeab **Trae\u56fd\u5185\u7248** - \u5185\u7f6e\u7684\u56fd\u5185\u6a21\u578b\u5b58\u5728\u654f\u611f\u8bcd\u5ba1\u67e5\u95ee\u9898\uff0c\u53ef\u80fd\u5bfc\u81f4\u4e13\u5bb6\u8fa9\u8bba\u8fc7\u7a0b\u4e2d\u65ad\uff0c\u5f71\u54cd\u4f7f\u7528\u4f53\u9a8c\n\n## \ud83d\udee0\ufe0f \u6280\u672f\u67b6\u6784\n\n**\u667a\u80fd\u5206\u5de5\u539f\u5219**\uff1a\n\n- \ud83e\udde0 **MCP Host\u7aef LLM**\uff1a\u8d1f\u8d23\u590d\u6742\u7684\u8bed\u4e49\u5206\u6790\u548c\u667a\u80fd\u751f\u6210\n- \ud83d\udd27 **MCP Server\u7aef**\uff1a\u63d0\u4f9b\u7b80\u6d01\u7684\u6d41\u7a0b\u63a7\u5236\u548c\u6570\u636e\u7ba1\u7406\n\n### \u52a8\u6001\u4e13\u5bb6\u751f\u6210\u6d41\u7a0b\n\n```mermaid\nflowchart TD\n    A[\ud83e\udd14 \u63d0\u51fa\u95ee\u9898] --> B[\ud83e\udde0 \u667a\u80fd\u5206\u6790]\n    B --> C[\ud83d\udc65 \u751f\u6210\u5019\u9009]\n    C --> D[\ud83d\ude80 \u5f00\u59cb\u8fa9\u8bba]\n    \n    A1[\u76f4\u63a5\u5411\u7cfb\u7edf\u63d0\u95ee\u4efb\u4f55\u8bdd\u9898]\n    B1[MCP Host\u7aefLLM\u6df1\u5ea6\u5206\u6790\u95ee\u9898\u7279\u5f81]\n    C1[\u52a8\u6001\u521b\u5efa3\u4f4d\u6700\u76f8\u5173\u7684\u4e13\u5bb6]\n    D1[\u542f\u52a8\u591a\u8f6ePK\u6d41\u7a0b]\n    \n    A -.-> A1\n    B -.-> B1\n    C -.-> C1\n    D -.-> D1\n    \n    style A fill:#e1f5fe\n    style B fill:#f3e5f5\n    style C fill:#e8f5e8\n    style D fill:#fff3e0\n```\n\n### \ud83d\udd04 \u8fa9\u8bba\u6d41\u7a0b\n\n**\u4e24\u79cd\u8fa9\u8bba\u6a21\u5f0f**\uff1a\n\n\ud83d\ude80 **\u6279\u5904\u7406\u6a21\u5f0f** (`start_pk_session`) - **\u9ed8\u8ba4\u63a8\u8350**\n\n- \u26a1 \u9ad8\u6548\u7387\uff1a\u4e00\u8f6e\u751f\u6210\u6240\u6709\u4e13\u5bb6\u56de\u7b54\uff0c\u8282\u7701\u7ea660%\u65f6\u95f4\n- \ud83c\udfaf \u9002\u7528\u573a\u666f\uff1a\u5feb\u901f\u83b7\u53d6\u591a\u89d2\u5ea6\u5206\u6790\uff0c\u9ad8\u6548\u51b3\u7b56\u652f\u6301\n\n\ud83d\udd04 **\u9010\u6b65\u6a21\u5f0f** (`start_stepwise_pk_session`) - \u4f20\u7edf\u4f53\u9a8c  \n\n- \ud83c\udfad \u4e92\u52a8\u6027\uff1a\u9010\u4e2a\u4e13\u5bb6\u53d1\u8a00\uff0c\u5b9e\u65f6\u8c03\u6574\u548c\u6df1\u5165\u63a2\u8ba8\n- \ud83c\udfaf \u9002\u7528\u573a\u666f\uff1a\u6df1\u5ea6\u601d\u8fa8\uff0c\u4eab\u53d7\u5b8c\u6574\u8fa9\u8bba\u8fc7\u7a0b\n\n**4\u8f6e\u8fa9\u8bba\u6d41\u7a0b**\uff1a\n\n```mermaid\nflowchart TD\n    A[\ud83e\udd14 \u72ec\u7acb\u601d\u8003] --> B[\u2694\ufe0f \u4ea4\u53c9\u8fa9\u8bba]\n    B --> C[\ud83c\udfaf \u6700\u7ec8\u7acb\u573a]\n    C --> D[\ud83e\udde0 \u667a\u6167\u7efc\u5408]\n    \n    A1[\u6bcf\u4f4d\u4e13\u5bb6\u72ec\u7acb\u5206\u6790\u95ee\u9898]\n    B1[\u4e13\u5bb6\u95f4\u4e92\u76f8\u8d28\u7591\u548c\u501f\u9274]\n    C1[\u5f62\u6210\u5404\u81ea\u5b8c\u5584\u7684\u65b9\u6848]\n    D1[\u878d\u5408\u5404\u65b9\u89c2\u70b9\u7684\u7ec8\u6781\u7b54\u6848]\n    \n    A -.-> A1\n    B -.-> B1\n    C -.-> C1\n    D -.-> D1\n    \n    B --> B2[\u591a\u8f6e\u4ea4\u4e92]\n    B2 --> B\n    \n    style A fill:#e3f2fd\n    style B fill:#fce4ec\n    style C fill:#e8f5e8\n    style D fill:#fff8e1\n    style B2 fill:#f3e5f5\n```\n\n## \ud83d\udcad \u8bbe\u8ba1\u7406\u5ff5\n\n### \u7075\u611f\u6765\u6e90\n\n\u672c\u9879\u76ee\u521d\u671f\u7684\u4e13\u5bb6\u7cfb\u7edf\u53d7\u5230 [\u4eba\u751f\u6559\u7ec3\u56e2Agent](https://mp.weixin.qq.com/s/QGNzRRo7U3Y2fmvOXNJvyw) \u7684\u542f\u53d1\uff0c\u5c06\u5185\u7f6e\u4e13\u5bb6\u7684\u591a\u89d2\u8272PK\u7684\u521b\u65b0\u601d\u8def\u901a\u8fc7\u672c\u5730MCP\u7684\u65b9\u5f0f\u5b9e\u73b0\u3002\n\n### \u6280\u672f\u65b9\u6848\u5bf9\u6bd4\n\n**\ud83d\udd27 Agent\u6846\u67b6\u5f00\u53d1**\n\n- \u2705 \u529f\u80fd\u5f3a\u5927\uff0c\u53ef\u96c6\u6210\u591a\u4e2aLLM API\n- \u2705 \u524d\u7aef\u4ea4\u4e92\u7075\u6d3b\uff0c\u63a7\u5236\u5f3a\u52b2\n- \u274c \u5f00\u53d1\u590d\u6742\u5ea6\u9ad8\uff0cAPI\u8c03\u7528\u6210\u672c\u9ad8\u6602\n\n**\u2601\ufe0f \u7b2c\u4e09\u65b9\u6587\u6863\u670d\u52a1\u8fdc\u7a0bMCP\u65b9\u6848(\u98de\u4e66MCP)**  \n\n- \u2705 \u90e8\u7f72\u7b80\u5355\uff0c\u5229\u7528\u73b0\u6709\u751f\u6001\n- \u274c \u4f9d\u8d56\u7b2c\u4e09\u65b9\u670d\u52a1\uff0c\u5b9a\u5236\u5316\u7a0b\u5ea6\u6709\u9650\n\n**\ud83c\udfe0 \u672c\u5730MCP\u65b9\u6848\uff08\u672c\u9879\u76ee\uff09**\n\n- \u2705 \u4e0e\u8ba2\u9605\u5236Chat APP\u7ed3\u5408\uff0c\u65e0API\u8d39\u7528\n- \u2705 \u6570\u636e\u672c\u5730\u5316\uff0c\u9690\u79c1\u4fdd\u62a4\n- \u2705 \u5f00\u6e90\u53ef\u5b9a\u5236\uff0c\u6280\u672f\u72ec\u7acb\n- \u2705 **\u667a\u80fd\u5206\u5de5\u67b6\u6784** - \u5145\u5206\u5229\u7528MCP Host\u7aefLLM\u667a\u80fd\n- \u2705 **\u52a8\u6001\u4e13\u5bb6\u751f\u6210** - \u7a81\u7834\u56fa\u5b9a\u4e13\u5bb6\u6c60\u9650\u5236\n- \u274c \u4f9d\u8d56MCP\u5ba2\u6237\u7aef\u5b9e\u73b0\n\n\u672c\u9879\u76ee\u6700\u65b0\u7684\u8bbe\u8ba1\uff0c\u901a\u8fc7\u5b8c\u5168\u7684\u52a8\u6001\u4e13\u5bb6\u751f\u6210\uff0c\u5b9e\u73b0\u4e86\u4ece\u56fa\u5b9a\u4e13\u5bb6\u5e93\u5230\u667a\u80fd\u4e13\u5bb6\u5de5\u5382\u7684\u6839\u672c\u6027\u7a81\u7834\u3002\n\u501f\u52a9\u4e8eMCP Host\u7aef\u5927\u8bed\u8a00\u6a21\u578b\u7684\u667a\u80fd\uff0cMCP\u670d\u52a1\u5668\u7aef(\u672c\u9879\u76ee)\u4e13\u6ce8\u6d41\u7a0b\u63a7\u5236\uff0c\u964d\u4f4e\u7ef4\u62a4\u6210\u672c\uff0c\u5b9e\u73b0\u667a\u80fd\u4e0e\u7b80\u6d01\u7684\u6700\u4f73\u5e73\u8861\u3002\n",
    "bugtrack_url": null,
    "license": "MIT License\n        \n        Copyright (c) 2025 MitsudoAI Team\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.",
    "summary": "MCP server enabling AI expert debates - Dynamic expert generation for personalized multi-round philosophical discussions on any topic",
    "version": "1.2.2",
    "project_urls": {
        "Bug Tracker": "https://github.com/MitsudoAI/guru-pk-mcp/issues",
        "Changelog": "https://github.com/MitsudoAI/guru-pk-mcp/releases",
        "Documentation": "https://github.com/MitsudoAI/guru-pk-mcp/blob/main/README.md",
        "Homepage": "https://github.com/MitsudoAI/guru-pk-mcp",
        "Issues": "https://github.com/MitsudoAI/guru-pk-mcp/issues",
        "Repository": "https://github.com/MitsudoAI/guru-pk-mcp.git",
        "Source Code": "https://github.com/MitsudoAI/guru-pk-mcp"
    },
    "split_keywords": [
        "ai",
        " claude-desktop",
        " cursor",
        " dynamic-experts",
        " expert-debate",
        " intelligent-generation",
        " mcp",
        " model-context-protocol",
        " multi-round-debate",
        " philosophy",
        " uvx"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d9a7445d41790e3c1af1f0217cda128b4138cd84832453a31e71fb270bba9ec5",
                "md5": "6e87243804ddad2d7be4dedf580523f6",
                "sha256": "eb67ccb80de891a4e2271a8b7edbb5b3df65067c6a36afa9d45861208e0c3198"
            },
            "downloads": -1,
            "filename": "guru_pk_mcp-1.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6e87243804ddad2d7be4dedf580523f6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 73565,
            "upload_time": "2025-07-13T17:16:18",
            "upload_time_iso_8601": "2025-07-13T17:16:18.541580Z",
            "url": "https://files.pythonhosted.org/packages/d9/a7/445d41790e3c1af1f0217cda128b4138cd84832453a31e71fb270bba9ec5/guru_pk_mcp-1.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "70d7181ef55af23cfaafe1641701dbd61f7f76fcc1281e8a74329e9e7401d522",
                "md5": "02bdbb37f33a2402df6934586a63abd1",
                "sha256": "e00dbd6fb8bb16e50dd6fb03742d6405904685234a30c0b4da3fc26cb7289efd"
            },
            "downloads": -1,
            "filename": "guru_pk_mcp-1.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "02bdbb37f33a2402df6934586a63abd1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 65363,
            "upload_time": "2025-07-13T17:16:19",
            "upload_time_iso_8601": "2025-07-13T17:16:19.825304Z",
            "url": "https://files.pythonhosted.org/packages/70/d7/181ef55af23cfaafe1641701dbd61f7f76fcc1281e8a74329e9e7401d522/guru_pk_mcp-1.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-13 17:16:19",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "MitsudoAI",
    "github_project": "guru-pk-mcp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "guru-pk-mcp"
}
None
Elapsed time: 0.58691s