Skip to content

V1.7.2

Choose a tag to compare

View all tags
@SepineTam SepineTam released this 06 Oct 05:48
· 658 commits to master since this release
v1.7.2
70ebae0

Stata-MCP v1.7.2 Release Notes

Release Date: October 6, 2025
Version: 1.7.2
License: Apache License 2.0

🚀 Overview

Stata-MCP version 1.7.2 introduces comprehensive agent mode support for AI-driven Stata analysis and optimizes dependencies by removing unused Jupyter-related packages. This release enhances AI integration capabilities while streamlining the installation process.

✨ New Features

🤖 Agent Mode Support

  • Interactive AI Agent: Added stata-mcp --agent command line option for agent mode
  • StataAgent Class: New StataAgent class with LangChain integration for AI-driven analysis
  • Multi-Model Support: Support for GPT-5, DeepSeek, and other OpenAI-compatible models
  • ReAct Prompt Template: Integrated ReAct (Reasoning + Acting) prompt template for enhanced AI reasoning
  • Interactive Workflow: Step-by-step interactive agent mode with data source and task input
  • MCP Client Integration: MultiServerMCPClient integration for seamless Stata command execution

📁 Agent Examples

  • LangChain Integration: Complete agent examples using LangChain and LangGraph
  • OpenAI Agent: Alternative OpenAI-based agent implementation
  • Task Prompt System: Advanced prompt generation system for agent tasks
  • Example Documentation: Comprehensive examples and README for agent usage

🚀 Agent Startup Script (agent.sh)

  • Automated Environment Detection: Smart detection of uv package manager with automatic fallback to pip
  • Python Version Validation: Ensures Python 3.11+ compatibility with clear error messaging
  • Interactive Installation: User-friendly prompts for uv installation with optional setup
  • Package Management: Automatic stata-mcp installation and version validation
  • Error Handling: Comprehensive error handling with colored output for better user experience
  • Cross-Platform Support: Compatible with macOS, Linux, and Windows environments
  • Usage: Simply run ./agent.sh to automatically set up and launch agent mode

✨ Changes

🔧 Dependency Optimization

  • Jupyter Dependencies Removed: Commented out unused Jupyter-related dependencies from pyproject.toml:
    • jupyter-client>=8.6.3
    • stata-kernel>=1.12.2
    • notebook>=7.4.5
    • jupyter>=1.1.1

🛠 Technical Details

  • No Functional Impact: Removal does not affect any core Stata-MCP functionality
  • Sandbox Module: Jupyter code exists only in experimental sandbox module which is unused by main application
  • Future Compatibility: Dependencies can be easily restored if sandbox feature development resumes

📋 Compatibility

✅ Supported Environments

  • Operating Systems: macOS, Windows, Linux
  • Python Versions: Python >= 3.11
  • Stata Versions: All modern Stata editions (MP, SE, IC)

🔄 Upgrade Benefits

  • Faster Installation: Reduced dependency tree speeds up installation
  • Smaller Footprint: Decreased package size and disk usage
  • Cleaner Dependencies: Streamlined dependency management
  • Seamless Transition: No breaking changes or configuration updates required

🐛 Bug Fixes

  • No critical issues in previous version
  • Dependency cleanup addresses potential unused package vulnerabilities

📈 Performance

  • Agent Mode: Enhanced AI-driven analysis with interactive workflow
  • Installation Speed: Faster package installation due to reduced dependencies
  • Reduced Overhead: Elimination of unused package loading
  • Maintenance: Simplified dependency management and updates
  • Startup Automation: Agent startup script eliminates manual setup steps

🚀 Quick Start with Agent Mode

Using the Startup Script (Recommended)

# Make the script executable
chmod +x agent.sh

# Run the automated setup and launch
./agent.sh

Manual Agent Mode Launch

# Using uv (faster)
uvx stata-mcp --agent

# Using pip
stata-mcp --agent

The startup script handles:

  • Environment detection and validation
  • Package installation if needed
  • Version checking and updates
  • Error handling and user guidance

🔮 Future Directions

  • Enhanced agent mode with multi-chat support
  • Continued dependency optimization
  • Enhanced core Stata integration features
  • Improved AI-assisted analysis capabilities
  • Streamlined user experience

Download: stata-mcp v1.7.2
PyPI: stata-mcp on PyPI

Assets 2
Loading