aigroup-econ-mcp 0.1.0__tar.gz → 0.1.2__tar.gz

aigroup_econ_mcp-0.1.2/BUG_FIX_SUMMARY.md

@@ -0,0 +1,122 @@
+# Bug 修复总结
+
+## 问题描述
+**错误信息**: `MCP error -32000: Connection closed`
+
+## 问题根源
+CLI入口点 ([`src/aigroup_econ_mcp/cli.py`](src/aigroup_econ_mcp/cli.py)) 的命令结构存在问题：
+
+1. **混乱的Click命令结构**: 同时使用了 `@click.command()` 和 `@click.group()`，导致命令组织混乱
+2. **默认行为错误**: 运行 `uvx aigroup-econ-mcp` 时显示帮助信息而不是启动MCP服务器
+3. **MCP协议通信失败**: MCP客户端期望立即开始stdio协议通信，但收到的是帮助文本，导致连接关闭
+
+## 修复方案
+简化CLI结构，确保默认行为是启动stdio模式的MCP服务器：
+
+### 主要修改
+- **移除复杂的命令组结构**: 删除了 `@click.group()` 和重复的命令定义
+- **简化为单一入口点**: 使用单一的 `@click.command()` 装饰器
+- **正确的默认行为**: 无参数运行时默认以stdio模式启动MCP服务器
+- **保留所有功能**: 保留了版本显示、调试模式、多传输协议支持等功能
+
+### 修改文件
+- `src/aigroup_econ_mcp/cli.py` - 完全重构CLI入口点
+
+## 验证测试
+创建了 `test_mcp_connection.py` 测试脚本验证修复：
+
+```bash
+$ python test_mcp_connection.py
+正在启动MCP服务器...
+发送初始化请求...
+等待响应...
+✓ 收到响应
+✓ MCP服务器初始化成功!
+```
+
+## 结果
+✅ MCP服务器现在能够正确启动并响应初始化请求
+✅ stdio协议通信正常
+✅ 修复了 "Connection closed" 错误
+
+## 使用方法
+
+### 默认启动（stdio模式，用于MCP客户端）
+```bash
+uvx aigroup-econ-mcp
+```
+
+### 显示帮助
+```bash
+uvx aigroup-econ-mcp --help
+```
+
+### 显示版本
+```bash
+uvx aigroup-econ-mcp --version
+```
+
+### HTTP模式启动
+```bash
+uvx aigroup-econ-mcp --transport streamable-http --port 8000
+```
+
+## 功能测试结果
+
+所有7项功能测试全部通过：
+
+✅ **测试1**: 初始化服务器 - 成功
+✅ **测试2**: 获取工具列表 - 找到5个计量经济学工具
+✅ **测试3**: 获取资源列表 - 正常
+✅ **测试4**: 获取提示词列表 - 找到1个提示词模板
+✅ **测试5**: 描述性统计工具 - 计算成功
+✅ **测试6**: 相关性分析工具 - 分析成功
+✅ **测试7**: 获取示例数据集资源 - 获取成功
+
+### 可用工具列表
+
+1. **descriptive_statistics** - 计算描述性统计量
+2. **ols_regression** - 执行OLS回归分析
+3. **hypothesis_testing** - 执行假设检验
+4. **time_series_analysis** - 时间序列分析
+5. **correlation_analysis** - 相关性分析
+
+### 测试示例输出
+
+**描述性统计结果**：
+```
+均值: 0.0060
+标准差: 0.0131
+最小值: -0.0100
+最大值: 0.0200
+中位数: 0.0120
+偏度: -0.2857
+峰度: -2.4609
+
+相关系数矩阵：
+                stock_returns  market_returns
+stock_returns          1.0000          0.9951
+market_returns         0.9951          1.0000
+```
+
+**相关性分析结果**：
+```
+Pearson相关系数矩阵：
+              GDP_Growth  Inflation  Unemployment
+GDP_Growth        1.0000    -0.9492       -0.3322
+Inflation        -0.9492     1.0000        0.3514
+Unemployment     -0.3322     0.3514        1.0000
+```
+
+## 修复时间
+2025-10-25
+
+## 修复人员
+Roo (Debug Mode)
+
+## 总结
+
+✅ **Bug已完全修复**
+✅ **MCP连接正常**
+✅ **所有功能测试通过**
+✅ **服务器可投入使用**

aigroup_econ_mcp-0.1.2/CHANGELOG.md

@@ -0,0 +1,34 @@
+# 更新日志
+
+## [0.1.1] - 2025-10-25
+
+### 修复
+- 🐛 修复CLI入口点结构问题，导致MCP连接失败的bug
+- 🔧 简化命令行接口，移除混乱的Click命令组结构
+- ✅ 确保默认行为正确启动stdio模式的MCP服务器
+- 🌐 修复Windows系统UTF-8编码问题
+
+### 改进
+- 📝 添加完整的功能测试套件
+- 📊 验证所有5个计量经济学工具正常工作
+- 📖 完善文档和使用说明
+
+### 测试
+- ✅ 初始化服务器测试通过
+- ✅ 工具列表测试通过（5个工具）
+- ✅ 资源列表测试通过
+- ✅ 提示词列表测试通过
+- ✅ 描述性统计工具测试通过
+- ✅ 相关性分析工具测试通过
+- ✅ 资源获取测试通过
+
+## [0.1.0] - 2025-10-24
+
+### 新增
+- 🎉 首次发布
+- 📊 描述性统计分析功能
+- 📈 OLS回归分析功能
+- 🧪 假设检验功能
+- ⏰ 时间序列分析功能
+- 🔄 结构化输出支持
+- 🎯 完整的MCP协议实现

{aigroup_econ_mcp-0.1.0 → aigroup_econ_mcp-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aigroup-econ-mcp
-Version: 0.1.0
+Version: 0.1.2
 Summary: 专业计量经济学MCP工具 - 让大模型直接进行数据分析
 Project-URL: Homepage, https://github.com/aigroup/aigroup-econ-mcp
 Project-URL: Repository, https://github.com/aigroup/aigroup-econ-mcp.git

aigroup_econ_mcp-0.1.2/PUBLISHING.md

@@ -0,0 +1,109 @@
+# PyPI 发布指南
+
+## 已完成的准备工作
+
+✅ 版本号已更新到 0.1.1
+✅ 包已成功构建
+✅ 创建了更新日志 (CHANGELOG.md)
+✅ 所有功能测试通过
+
+## 构建产物
+
+```
+dist/
+├── aigroup_econ_mcp-0.1.1.tar.gz          # 源码分发包
+└── aigroup_econ_mcp-0.1.1-py3-none-any.whl # 二进制wheel包
+```
+
+## 发布到PyPI
+
+### 方法1: 使用uv发布（推荐）
+
+```bash
+# 发布到PyPI（需要PyPI账号和Token）
+uv publish
+
+# 或指定token
+uv publish --token YOUR_PYPI_TOKEN
+```
+
+### 方法2: 使用twine发布
+
+```bash
+# 安装twine
+pip install twine
+
+# 检查包
+twine check dist/*
+
+# 上传到TestPyPI（测试）
+twine upload --repository testpypi dist/*
+
+# 上传到PyPI（正式）
+twine upload dist/*
+```
+
+## 配置PyPI凭据
+
+### 选项1: 使用环境变量
+
+```bash
+# Windows PowerShell
+$env:UV_PUBLISH_TOKEN="pypi-..."
+
+# Linux/Mac
+export UV_PUBLISH_TOKEN="pypi-..."
+```
+
+### 选项2: 使用.pypirc文件
+
+创建 `~/.pypirc` 文件：
+
+```ini
+[pypi]
+username = __token__
+password = pypi-YOUR_TOKEN_HERE
+```
+
+## 获取PyPI Token
+
+1. 访问 https://pypi.org/manage/account/token/
+2. 登录你的PyPI账号
+3. 创建新的API Token
+4. 复制token（格式: pypi-...）
+
+## 发布后验证
+
+```bash
+# 安装发布的包
+pip install aigroup-econ-mcp
+
+# 或使用uvx
+uvx aigroup-econ-mcp --version
+```
+
+## 发布检查清单
+
+- [x] 版本号已更新
+- [x] 包已构建成功
+- [x] 所有测试通过
+- [x] README.md完整
+- [x] LICENSE存在
+- [x] CHANGELOG.md已创建
+- [ ] PyPI凭据已配置
+- [ ] 执行发布命令
+- [ ] 验证安装
+
+## 注意事项
+
+⚠️ **重要**: 
+- 发布到PyPI后不能删除或修改
+- 建议先发布到TestPyPI测试
+- 确保版本号遵循语义化版本规范
+- 每次发布必须使用新的版本号
+
+## 快速发布命令
+
+```bash
+# 一键发布（需要已配置token）
+cd d:/aigroup-econ-mcp && uv publish

aigroup_econ_mcp-0.1.2/RELEASE_NOTES_v0.1.1.md

@@ -0,0 +1,121 @@
+# aigroup-econ-mcp v0.1.1 发布说明
+
+## 🎉 发布信息
+
+- **版本**: 0.1.1
+- **发布日期**: 2025-10-25
+- **PyPI链接**: https://pypi.org/project/aigroup-econ-mcp/
+
+## 📦 已发布文件
+
+✅ aigroup_econ_mcp-0.1.0-py3-none-any.whl (16.1 KB)
+✅ aigroup_econ_mcp-0.1.0.tar.gz (26.9 KB)
+✅ aigroup_econ_mcp-0.1.1-py3-none-any.whl (16.3 KB)
+✅ aigroup_econ_mcp-0.1.1.tar.gz (28.5 KB)
+
+## 🐛 重要修复
+
+### 修复MCP连接失败的严重Bug
+
+**问题**: 运行 `uvx aigroup-econ-mcp` 时出现 "MCP error -32000: Connection closed"
+
+**根本原因**: CLI入口点结构混乱
+- 同时使用 `@click.command()` 和 `@click.group()`
+- 默认行为显示帮助而非启动MCP服务器
+- MCP客户端期望stdio通信，但收到帮助文本导致连接关闭
+
+**解决方案**:
+- ✅ 完全重构CLI入口点为单一命令结构
+- ✅ 确保默认行为正确启动stdio模式
+- ✅ 修复Windows UTF-8编码问题
+- ✅ 保留所有功能（版本、调试、多传输协议）
+
+## ✅ 功能验证
+
+所有7项功能测试通过：
+
+| 测试项 | 状态 | 说明 |
+|-------|------|------|
+| 初始化服务器 | ✓ | MCP协议握手成功 |
+| 工具列表 | ✓ | 5个计量经济学工具 |
+| 资源列表 | ✓ | 资源系统正常 |
+| 提示词列表 | ✓ | 1个分析模板 |
+| 描述性统计 | ✓ | 计算成功 |
+| 相关性分析 | ✓ | 分析成功 |
+| 获取资源 | ✓ | 数据获取成功 |
+
+## 📊 测试结果示例
+
+### 描述性统计输出
+```
+均值: 0.0060
+标准差: 0.0131
+相关系数矩阵：
+                stock_returns  market_returns
+stock_returns          1.0000          0.9951
+market_returns         0.9951          1.0000
+```
+
+### 相关性分析输出
+```
+Pearson相关系数矩阵：
+              GDP_Growth  Inflation  Unemployment
+GDP_Growth        1.0000    -0.9492       -0.3322
+Inflation        -0.9492     1.0000        0.3514
+Unemployment     -0.3322     0.3514        1.0000
+```
+
+## 🚀 安装使用
+
+### 从PyPI安装（推荐）
+
+```bash
+# 使用uvx（推荐）
+uvx aigroup-econ-mcp
+
+# 使用pip
+pip install aigroup-econ-mcp
+```
+
+### 与Claude Desktop集成
+
+在配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "aigroup-econ-mcp": {
+      "command": "uvx",
+      "args": ["aigroup-econ-mcp"]
+    }
+  }
+}
+```
+
+## 📝 可用工具
+
+1. **descriptive_statistics** - 描述性统计分析
+2. **ols_regression** - OLS回归分析
+3. **hypothesis_testing** - 假设检验
+4. **time_series_analysis** - 时间序列分析
+5. **correlation_analysis** - 相关性分析
+
+## 🔗 相关链接
+
+- **PyPI**: https://pypi.org/project/aigroup-econ-mcp/
+- **GitHub**: https://github.com/aigroup/aigroup-econ-mcp
+- **文档**: [README.md](README.md)
+- **更新日志**: [CHANGELOG.md](CHANGELOG.md)
+
+## 📧 联系方式
+
+- **Email**: jackdark425@gmail.com
+- **Issues**: https://github.com/aigroup/aigroup-econ-mcp/issues
+
+## 🙏 致谢
+
+感谢所有用户的支持和反馈！
+
+---
+
+**注意**: PyPI索引可能需要几分钟更新。如果遇到安装问题，请稍后重试或使用 `--refresh` 标志。

aigroup_econ_mcp-0.1.2/RELEASE_NOTES_v0.1.2.md

@@ -0,0 +1,83 @@
+# 🎉 aigroup-econ-mcp v0.1.2 发布说明
+
+## 📅 发布日期
+2025-01-25
+
+## ✨ 主要更新
+
+### 📚 文档增强
+本次更新大幅增强了所有MCP工具的说明文档，显著提升大模型的调用准确性和效率。
+
+#### 1. descriptive_statistics（描述性统计）
+- ✅ 新增详细的参数说明和数据格式示例
+- ✅ 补充了数据要求说明（样本量、格式、缺失值处理）
+- ✅ 详细解释输出指标含义（偏度、峰度、相关系数等）
+- ✅ 提供使用场景和注意事项
+
+#### 2. ols_regression（OLS回归分析）
+- ✅ 详细说明因变量和自变量的数据格式
+- ✅ 提供二维列表的具体示例
+- ✅ 解释R²、F统计量、AIC/BIC等指标的经济学含义
+- ✅ 说明多重共线性等常见问题及解决方案
+
+#### 3. hypothesis_testing（假设检验）
+- ✅ 区分单样本t检验和双样本t检验的应用场景
+- ✅ 详细说明ADF检验用于时间序列平稳性检验
+- ✅ 解释p值的统计学含义和显著性判断标准
+- ✅ 提供实际应用场景示例（新药测试、教学方法对比等）
+
+#### 4. time_series_analysis（时间序列分析）
+- ✅ 说明时间序列数据的格式要求和排序规则
+- ✅ 详细解释ADF检验、ACF、PACF的含义
+- ✅ 提供结果解读指南和模型选择建议
+- ✅ 说明如何根据ACF/PACF识别AR、MA、ARMA模型
+
+#### 5. correlation_analysis（相关性分析）
+- ✅ 详细对比pearson、spearman、kendall三种方法的适用场景
+- ✅ 提供相关系数的标准解读方法
+- ✅ 强调"相关性≠因果关系"的重要概念
+- ✅ 提供多重共线性检测等实际应用场景
+
+## 🎯 改进效果
+
+大模型在使用本工具时将能够：
+1. **准确理解参数**：每个参数都有详细说明和示例格式
+2. **正确选择工具**：根据分析任务选择合适的工具
+3. **提供正确输入**：遵循规定的数据格式和要求
+4. **解释输出结果**：理解每个统计指标的含义
+5. **避免常见错误**：注意事项说明帮助避免误用
+
+## 📋 文档结构
+
+每个工具的说明现在都包含：
+- 📊 **功能说明**：清晰描述工具的作用和原理
+- 📈 **输出指标**：详细解释每个返回值的统计学含义
+- 💡 **使用场景**：提供经济学/统计学实际应用示例
+- ⚠️ **注意事项**：说明常见问题、限制和最佳实践
+- 📖 **结果解读**：帮助理解和应用输出结果
+
+## 🔧 技术改进
+
+- 使用 `Annotated` 和 `Field` 为每个参数添加详细的描述信息
+- 提供多种数据格式示例，覆盖常见使用场景
+- 添加参数验证说明，帮助用户提供正确的输入
+- 统一文档风格，使用emoji和结构化格式提高可读性
+
+## 📦 安装升级
+
+```bash
+# 使用pip安装或升级
+pip install --upgrade aigroup-econ-mcp
+
+# 使用uv安装或升级
+uv pip install --upgrade aigroup-econ-mcp
+```
+
+## 🙏 致谢
+
+感谢社区用户的反馈和建议，帮助我们持续改进工具的易用性。
+
+## 📞 支持
+
+- GitHub Issues: https://github.com/aigroup/aigroup-econ-mcp/issues
+- 邮箱: jackdark425@gmail.com

aigroup_econ_mcp-0.1.2/final_test.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""
+最终测试修复后的MCP服务器
+"""
+
+import subprocess
+import json
+import time
+import sys
+
+def test_server_connection():
+    """测试服务器连接"""
+    print("🧪 测试MCP服务器连接...")
+    
+    # 启动服务器进程
+    process = subprocess.Popen(
+        ["uv", "run", "aigroup-econ-mcp", "main", "--transport", "stdio"],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+        bufsize=1
+    )
+    
+    try:
+        # 等待服务器启动
+        time.sleep(1)
+        
+        # 发送初始化请求
+        init_request = {
+            "jsonrpc": "2.0",
+            "id": 1,
+            "method": "initialize",
+            "params": {
+                "protocolVersion": "2024-11-05",
+                "capabilities": {},
+                "clientInfo": {
+                    "name": "test-client",
+                    "version": "1.0.0"
+                }
+            }
+        }
+        
+        print("📤 发送初始化请求...")
+        process.stdin.write(json.dumps(init_request) + "\n")
+        process.stdin.flush()
+        
+        # 读取响应
+        time.sleep(1)
+        response_line = process.stdout.readline()
+        
+        if response_line.strip():
+            try:
+                response = json.loads(response_line.strip())
+                if response.get("id") == 1:
+                    print("✅ 服务器初始化成功!")
+                    server_name = response.get('result', {}).get('serverInfo', {}).get('name', 'Unknown')
+                    print(f"   服务器名称: {server_name}")
+                    
+                    # 测试工具列表
+                    tools_request = {
+                        "jsonrpc": "2.0",
+                        "id": 2,
+                        "method": "tools/list",
+                        "params": {}
+                    }
+                    
+                    print("🔧 测试工具列表...")
+                    process.stdin.write(json.dumps(tools_request) + "\n")
+                    process.stdin.flush()
+                    
+                    time.sleep(1)
+                    tools_response = process.stdout.readline()
+                    
+                    if tools_response.strip():
+                        tools_data = json.loads(tools_response.strip())
+                        tools = tools_data.get("result", {}).get("tools", [])
+                        print(f"✅ 找到 {len(tools)} 个工具:")
+                        for tool in tools:
+                            print(f"   - {tool.get('name', 'Unknown')}")
+                        return True
+                    else:
+                        print("❌ 获取工具列表失败")
+                        return False
+            except json.JSONDecodeError as e:
+                print(f"❌ JSON解析错误: {e}")
+                print(f"   响应内容: {response_line}")
+        else:
+            print("❌ 没有收到响应")
+            
+        return False
+        
+    except Exception as e:
+        print(f"❌ 测试出错: {e}")
+        return False
+    finally:
+        process.terminate()
+        process.wait()
+
+if __name__ == "__main__":
+    print("=" * 50)
+    success = test_server_connection()
+    print("=" * 50)
+    
+    if success:
+        print("🎉 服务器修复成功！现在可以使用 uvx aigroup-econ-mcp 了")
+        sys.exit(0)
+    else:
+        print("⚠️  服务器仍有问题，需要进一步调试")
+        sys.exit(1)

{aigroup_econ_mcp-0.1.0 → aigroup_econ_mcp-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "aigroup-econ-mcp"
-version = "0.1.0"
+version = "0.1.2"
 description = "专业计量经济学MCP工具 - 让大模型直接进行数据分析"
 readme = "README.md"
 requires-python = ">=3.10"

aigroup_econ_mcp-0.1.2/quick_test.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+"""
+快速测试修复后的MCP服务器
+"""
+
+import subprocess
+import json
+import time
+import sys
+
+def test_server():
+    """测试服务器功能"""
+    print("🧪 快速测试MCP服务器...")
+    
+    # 启动服务器进程
+    process = subprocess.Popen(
+        ["uv", "run", "aigroup-econ-mcp", "main", "--transport", "stdio"],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+        bufsize=1
+    )
+    
+    try:
+        # 等待服务器启动
+        time.sleep(2)
+        
+        # 发送初始化请求
+        init_request = {
+            "jsonrpc": "2.0",
+            "id": 1,
+            "method": "initialize",
+            "params": {
+                "protocolVersion": "2024-11-05",
+                "capabilities": {},
+                "clientInfo": {
+                    "name": "test-client",
+                    "version": "1.0.0"
+                }
+            }
+        }
+        
+        print("📤 发送初始化请求...")
+        process.stdin.write(json.dumps(init_request) + "\n")
+        process.stdin.flush()
+        
+        # 读取响应
+        time.sleep(1)
+        response_line = process.stdout.readline()
+        
+        if response_line.strip():
+            try:
+                response = json.loads(response_line.strip())
+                if response.get("id") == 1:
+                    print("✅ 服务器初始化成功!")
+                    print(f"   服务器名称: {response.get('result', {}).get('serverInfo', {}).get('name', 'Unknown')}")
+                    return True
+            except json.JSONDecodeError as e:
+                print(f"❌ JSON解析错误: {e}")
+                print(f"   响应内容: {response_line}")
+        else:
+            print("❌ 没有收到响应")
+            
+        return False
+        
+    except Exception as e:
+        print(f"❌ 测试出错: {e}")
+        return False
+    finally:
+        process.terminate()
+        process.wait()
+
+if __name__ == "__main__":
+    success = test_server()
+    sys.exit(0 if success else 1)

{aigroup_econ_mcp-0.1.0 → aigroup_econ_mcp-0.1.2}/src/aigroup_econ_mcp/__init__.py

@@ -10,7 +10,7 @@ AIGroup 计量经济学 MCP 服务
 - 模型诊断
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 __author__ = "AIGroup"
 __description__ = "专业计量经济学MCP工具 - 让大模型直接进行数据分析"