tree-sitter-analyzer 1.6.2__tar.gz → 1.7.0__tar.gz

{tree_sitter_analyzer-1.6.2 → tree_sitter_analyzer-1.7.0}/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## [1.7.0] - 2025-10-09
+
+### Added
+- **🎯 suppress_output Feature**: Revolutionary token optimization feature for `analyze_code_structure` tool
+  - **Token Limit Solution**: New `suppress_output` parameter reduces response size by up to 99% when saving to files
+  - **Smart Output Control**: When `suppress_output=true` and `output_file` is specified, only essential metadata is returned
+  - **Backward Compatibility**: Optional feature that doesn't affect existing functionality
+  - **Performance Optimization**: Dramatically reduces context usage for large analysis results
+
+- **📊 Enhanced MCP Tools Documentation**: Comprehensive MCP tools reference and usage guide
+  - **Complete Tool List**: All 12 MCP tools documented with detailed descriptions
+  - **Usage Examples**: Practical examples for each tool with real-world scenarios
+  - **Parameter Reference**: Complete parameter documentation for all tools
+  - **Integration Guide**: Step-by-step setup instructions for AI assistants
+
+- **🌐 Multi-language Documentation Updates**: Synchronized documentation across all language versions
+  - **Chinese (README_zh.md)**: Updated with new statistics and MCP tools documentation
+  - **Japanese (README_ja.md)**: Complete translation with feature explanations
+  - **English (README.md)**: Enhanced with comprehensive MCP tools reference
+
+### Improved
+- **📊 Quality Metrics**:
+  - Test count increased to 2662 (up from 2046)
+  - Code coverage maintained at 79.16%
+  - All tests passing with improved system stability
+- **🔧 Code Quality**: Enhanced suppress_output feature implementation and testing
+- **📚 Documentation**: Updated all README versions with new statistics and comprehensive MCP tools documentation
+
+### Technical Details
+- **New Files**:
+  - `examples/suppress_output_demo.py` - Demonstration of suppress_output feature
+  - `tests/test_suppress_output_feature.py` - 356 comprehensive test cases
+- **Enhanced Files**:
+  - `tree_sitter_analyzer/mcp/tools/table_format_tool.py` - Added suppress_output functionality
+  - All README files updated with v1.7.0 statistics and MCP tools documentation
+- **Test Coverage**: All 2662 tests passing with 79.16% coverage
+- **Quality Metrics**: Enhanced suppress_output feature with comprehensive validation
+- **Breaking Changes**: None - all improvements are backward compatible
+
+This minor release introduces the game-changing suppress_output feature that solves token length limitations for large analysis results, along with comprehensive MCP tools documentation across all language versions.
+
 ## [1.6.2] - 2025-10-07
 
 ### Added

{tree_sitter_analyzer-1.6.2 → tree_sitter_analyzer-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.6.2
+Version: 1.7.0
 Summary: Extensible multi-language code analyzer framework using Tree-sitter with dynamic plugin architecture
 Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
 Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
@@ -165,11 +165,11 @@ Description-Content-Type: text/markdown
 
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-2046%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-69.67%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-2662%20passed-brightgreen.svg)](#quality-assurance)
+[![Coverage](https://img.shields.io/badge/coverage-79.16%25-green.svg)](#quality-assurance)
 [![Quality](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#quality-assurance)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
-[![Version](https://img.shields.io/badge/version-1.6.2-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.7.0-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 Enterprise-Grade Code Analysis Tool for the AI Era
@@ -220,12 +220,12 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 - **Java** - Full support (1103 lines of plugin code, 73% coverage), including Spring, JPA frameworks
 - **Python** - Full support (584 lines of plugin code, 63% coverage), including type annotations, decorators
 - **JavaScript** - Enterprise-grade support (1445 lines of plugin code, 68% coverage), including ES6+, React/Vue/Angular, JSX
-- **TypeScript** - **Complete support** (1553 lines of plugin code, 29% coverage), including interfaces, types, decorators, TSX/JSX, framework detection
+- **TypeScript** - **Complete support** (1729 lines of plugin code, 72.82% coverage), including interfaces, types, decorators, TSX/JSX, framework detection
 - **More Languages** - Basic support for C/C++, Rust, Go
 
 ### 🏆 Production Ready
-- **2,046 Tests** - 100% pass rate, enterprise-grade quality assurance
-- **69.67% Coverage** - Comprehensive test suite
+- **2,662 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **79.16% Coverage** - Comprehensive test suite
 - **Cross-Platform Support** - Full compatibility with Windows, macOS, Linux
 - **Continuous Maintenance** - Active development and community support
 
@@ -256,26 +256,15 @@ uv --version
 
 **fd** and **ripgrep** are high-performance file and content search tools used for advanced MCP features.
 
-```bash
-# macOS
-brew install fd ripgrep
-
-# Windows (recommended using winget)
-winget install sharkdp.fd BurntSushi.ripgrep.MSVC
-
-# Windows (alternative methods)
-# choco install fd ripgrep
-# scoop install fd ripgrep
-
-# Ubuntu/Debian
-sudo apt install fd-find ripgrep
-
-# CentOS/RHEL/Fedora
-sudo dnf install fd-find ripgrep
-
-# Arch Linux
-sudo pacman -S fd ripgrep
-```
+| Operating System | Package Manager | Installation Command | Notes |
+|-----------------|-----------------|---------------------|-------|
+| **macOS** | Homebrew | `brew install fd ripgrep` | Recommended method |
+| **Windows** | winget | `winget install sharkdp.fd BurntSushi.ripgrep.MSVC` | Recommended method |
+| | Chocolatey | `choco install fd ripgrep` | Alternative method |
+| | Scoop | `scoop install fd ripgrep` | Alternative method |
+| **Ubuntu/Debian** | apt | `sudo apt install fd-find ripgrep` | Official repository |
+| **CentOS/RHEL/Fedora** | dnf | `sudo dnf install fd-find ripgrep` | Official repository |
+| **Arch Linux** | pacman | `sudo pacman -S fd ripgrep` | Official repository |
 
 **Verify installation:**
 ```bash
@@ -680,6 +669,34 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 
 ---
 
+## 🤖 Complete MCP Tools List
+
+Tree-sitter Analyzer provides a rich set of MCP tools designed for AI assistants:
+
+| Tool Category | Tool Name | Primary Function | Core Features |
+|--------------|-----------|------------------|---------------|
+| **📊 Code Analysis** | `analyze_code_structure` | Analyze code structure and generate tables | 🆕 suppress_output parameter, multiple formats (full/compact/csv/json), automatic language detection |
+| | `check_code_scale` | Fast code file scale analysis | File size statistics, line count statistics, complexity analysis, performance metrics |
+| | `extract_code_section` | Precise code section extraction | Specified line range extraction, efficient large file processing, preserve original formatting |
+| **🔍 Intelligent Search** | `list_files` | High-performance file discovery | fd-based, glob patterns, file type filtering, time range control |
+| | `search_content` | Regular expression content search | ripgrep-based, multiple output formats, context control, encoding handling |
+| | `find_and_grep` | Two-stage search | Find files → search content, fd+ripgrep combination, intelligent caching optimization |
+| **🔧 Advanced Query** | `query_code` | tree-sitter queries | Predefined query keys, custom query strings, filter expression support |
+| **⚙️ System Management** | `set_project_path` | Set project root path | Security boundary control, automatic path validation |
+| **📁 Resource Access** | Code File Resources | URI code file access | Access file content through URI identification |
+| | Project Statistics Resources | Project statistics data access | Project analysis data and statistical information |
+
+### 🆕 v1.7.0 New Feature: suppress_output Functionality
+
+The newly added `suppress_output` parameter in the `analyze_code_structure` tool is a revolutionary token optimization feature:
+
+- **Problem Solved**: When analysis results are too large, traditional methods return complete table data, consuming massive tokens
+- **Intelligent Optimization**: When `suppress_output=true` and `output_file` is specified, only basic metadata is returned
+- **Significant Effect**: Can reduce response size by up to 99%, dramatically saving AI dialog token consumption
+- **Use Cases**: Particularly suitable for large code file structure analysis and batch processing scenarios
+
+---
+
 ## 🛠️ Core Features
 
 ### 📊 Code Structure Analysis
@@ -708,11 +725,16 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 - **Other MCP-compatible tools** - Universal MCP server
 
 ### 🌍 Multi-Language Support
-- **Java** - Full support (1103 lines of plugin), including Spring, JPA frameworks
-- **Python** - Full support (584 lines of plugin), including type annotations, decorators
-- **JavaScript** - Enterprise-grade support (1445 lines of plugin), including ES6+, React/Vue/Angular, JSX
-- **TypeScript** - **Complete support** (1553 lines of plugin), including interfaces, types, decorators, TSX/JSX, framework detection
-- **C/C++, Rust, Go** - Basic support
+
+| Programming Language | Support Level | Plugin Code Lines | Test Coverage | Key Features |
+|---------------------|---------------|-------------------|---------------|--------------|
+| **Java** | Full Support | 1,103 lines | 73.00% | Spring framework, JPA, enterprise features |
+| **Python** | Full Support | 584 lines | 63.26% | Type annotations, decorators, modern Python features |
+| **JavaScript** | Full Support | 1,445 lines | 68.31% | ES6+, React/Vue/Angular, JSX |
+| **TypeScript** | Full Support | 1,729 lines | 72.82% | Interfaces, types, decorators, TSX/JSX, framework detection |
+| **C/C++** | Basic Support | - | - | Basic syntax parsing |
+| **Rust** | Basic Support | - | - | Basic syntax parsing |
+| **Go** | Basic Support | - | - | Basic syntax parsing |
 
 ### 📁 Advanced File Search
 Powerful file discovery and content search based on fd and ripgrep:
@@ -731,16 +753,18 @@ Powerful file discovery and content search based on fd and ripgrep:
 ## 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **1,893 Tests** - 100% pass rate ✅
-- **71.48% Code Coverage** - Comprehensive test suite
+- **2,662 Tests** - 100% pass rate ✅
+- **79.16% Code Coverage** - Comprehensive test suite
 - **Zero Test Failures** - Production ready
 - **Cross-Platform Support** - Windows, macOS, Linux
 
-### ⚡ Latest Quality Achievements (v1.6.0)
+### ⚡ Latest Quality Achievements (v1.7.0)
+- ✅ **Token Saving Feature** - New suppress_output parameter automatically suppresses table output when file output is specified, saving AI token consumption
+- ✅ **Intelligent Output Control** - Automatically optimize response size when output_file is specified and suppress_output=true
+- ✅ **Enterprise-Grade Test Coverage** - Added 356 new test cases specifically for suppress_output functionality
+- ✅ **MCP Tools Enhancement** - Complete MCP server toolset supporting advanced file search and content analysis
 - ✅ **Cross-Platform Path Compatibility** - Fixed Windows short path names and macOS symlink differences
-- ✅ **Enterprise-Grade Reliability** - 50+ comprehensive test cases ensure stability
 - ✅ **GitFlow Implementation** - Professional development/release branch strategy
-- ✅ **AI Collaboration Optimization** - Specialized quality control for AI-assisted development
 
 ### ⚙️ Running Tests
 ```bash
@@ -756,22 +780,19 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 
 ### 📈 Test Coverage Details
 
-**Core Modules:**
-- **Language Detector**: 98.41% (Excellent) - Automatic programming language recognition
-- **CLI Main Entry**: 94.36% (Excellent) - Command-line interface
-- **Query Filter System**: 96.06% (Excellent) - Code query and filtering
-- **Query Service**: 86.25% (Good) - Query execution engine
-- **MCP Error Handling**: 82.76% (Good) - AI assistant integration error handling
-
-**Language Plugins:**
-- **Java Plugin**: 73.00% (Good) - 1103 lines of code, full enterprise-grade support
-- **JavaScript Plugin**: 68.31% (Good) - 1445 lines of code, modern ES6+ feature support
-- **Python Plugin**: 63.26% (Good) - 584 lines of code, full type annotation support
-
-**MCP Tools:**
-- **File Search Tool**: 88.77% (Excellent) - fd/ripgrep integration
-- **Content Search Tool**: 92.70% (Excellent) - Regular expression search
-- **Combined Search Tool**: 91.57% (Excellent) - Two-stage search
+| Module Category | Component | Coverage | Quality Level | Code Lines | Features |
+|-----------------|-----------|----------|---------------|------------|----------|
+| **Core Modules** | Language Detector | 98.41% | Excellent | - | Automatic programming language recognition |
+| | CLI Main Entry | 94.36% | Excellent | - | Command-line interface |
+| | Query Filter System | 96.06% | Excellent | - | Code query and filtering |
+| | Query Service | 86.25% | Good | - | Query execution engine |
+| | MCP Error Handling | 82.76% | Good | - | AI assistant integration error handling |
+| **Language Plugins** | Java Plugin | 80.30% | Excellent | 1333 | Full enterprise-grade support |
+| | JavaScript Plugin | 76.74% | Good | 1539 | Modern ES6+ feature support |
+| | Python Plugin | 82.84% | Excellent | 1296 | Full type annotation support |
+| **MCP Tools** | File Search Tool | 88.77% | Excellent | - | fd/ripgrep integration |
+| | Content Search Tool | 92.70% | Excellent | - | Regular expression search |
+| | Combined Search Tool | 91.57% | Excellent | - | Two-stage search |
 
 ### ✅ Documentation Verification Status
 

{tree_sitter_analyzer-1.6.2 → tree_sitter_analyzer-1.7.0}/README.md

@@ -4,11 +4,11 @@
 
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-2046%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-69.67%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-2662%20passed-brightgreen.svg)](#quality-assurance)
+[![Coverage](https://img.shields.io/badge/coverage-79.16%25-green.svg)](#quality-assurance)
 [![Quality](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#quality-assurance)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
-[![Version](https://img.shields.io/badge/version-1.6.2-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.7.0-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 Enterprise-Grade Code Analysis Tool for the AI Era
@@ -59,12 +59,12 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 - **Java** - Full support (1103 lines of plugin code, 73% coverage), including Spring, JPA frameworks
 - **Python** - Full support (584 lines of plugin code, 63% coverage), including type annotations, decorators
 - **JavaScript** - Enterprise-grade support (1445 lines of plugin code, 68% coverage), including ES6+, React/Vue/Angular, JSX
-- **TypeScript** - **Complete support** (1553 lines of plugin code, 29% coverage), including interfaces, types, decorators, TSX/JSX, framework detection
+- **TypeScript** - **Complete support** (1729 lines of plugin code, 72.82% coverage), including interfaces, types, decorators, TSX/JSX, framework detection
 - **More Languages** - Basic support for C/C++, Rust, Go
 
 ### 🏆 Production Ready
-- **2,046 Tests** - 100% pass rate, enterprise-grade quality assurance
-- **69.67% Coverage** - Comprehensive test suite
+- **2,662 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **79.16% Coverage** - Comprehensive test suite
 - **Cross-Platform Support** - Full compatibility with Windows, macOS, Linux
 - **Continuous Maintenance** - Active development and community support
 
@@ -95,26 +95,15 @@ uv --version
 
 **fd** and **ripgrep** are high-performance file and content search tools used for advanced MCP features.
 
-```bash
-# macOS
-brew install fd ripgrep
-
-# Windows (recommended using winget)
-winget install sharkdp.fd BurntSushi.ripgrep.MSVC
-
-# Windows (alternative methods)
-# choco install fd ripgrep
-# scoop install fd ripgrep
-
-# Ubuntu/Debian
-sudo apt install fd-find ripgrep
-
-# CentOS/RHEL/Fedora
-sudo dnf install fd-find ripgrep
-
-# Arch Linux
-sudo pacman -S fd ripgrep
-```
+| Operating System | Package Manager | Installation Command | Notes |
+|-----------------|-----------------|---------------------|-------|
+| **macOS** | Homebrew | `brew install fd ripgrep` | Recommended method |
+| **Windows** | winget | `winget install sharkdp.fd BurntSushi.ripgrep.MSVC` | Recommended method |
+| | Chocolatey | `choco install fd ripgrep` | Alternative method |
+| | Scoop | `scoop install fd ripgrep` | Alternative method |
+| **Ubuntu/Debian** | apt | `sudo apt install fd-find ripgrep` | Official repository |
+| **CentOS/RHEL/Fedora** | dnf | `sudo dnf install fd-find ripgrep` | Official repository |
+| **Arch Linux** | pacman | `sudo pacman -S fd ripgrep` | Official repository |
 
 **Verify installation:**
 ```bash
@@ -519,6 +508,34 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 
 ---
 
+## 🤖 Complete MCP Tools List
+
+Tree-sitter Analyzer provides a rich set of MCP tools designed for AI assistants:
+
+| Tool Category | Tool Name | Primary Function | Core Features |
+|--------------|-----------|------------------|---------------|
+| **📊 Code Analysis** | `analyze_code_structure` | Analyze code structure and generate tables | 🆕 suppress_output parameter, multiple formats (full/compact/csv/json), automatic language detection |
+| | `check_code_scale` | Fast code file scale analysis | File size statistics, line count statistics, complexity analysis, performance metrics |
+| | `extract_code_section` | Precise code section extraction | Specified line range extraction, efficient large file processing, preserve original formatting |
+| **🔍 Intelligent Search** | `list_files` | High-performance file discovery | fd-based, glob patterns, file type filtering, time range control |
+| | `search_content` | Regular expression content search | ripgrep-based, multiple output formats, context control, encoding handling |
+| | `find_and_grep` | Two-stage search | Find files → search content, fd+ripgrep combination, intelligent caching optimization |
+| **🔧 Advanced Query** | `query_code` | tree-sitter queries | Predefined query keys, custom query strings, filter expression support |
+| **⚙️ System Management** | `set_project_path` | Set project root path | Security boundary control, automatic path validation |
+| **📁 Resource Access** | Code File Resources | URI code file access | Access file content through URI identification |
+| | Project Statistics Resources | Project statistics data access | Project analysis data and statistical information |
+
+### 🆕 v1.7.0 New Feature: suppress_output Functionality
+
+The newly added `suppress_output` parameter in the `analyze_code_structure` tool is a revolutionary token optimization feature:
+
+- **Problem Solved**: When analysis results are too large, traditional methods return complete table data, consuming massive tokens
+- **Intelligent Optimization**: When `suppress_output=true` and `output_file` is specified, only basic metadata is returned
+- **Significant Effect**: Can reduce response size by up to 99%, dramatically saving AI dialog token consumption
+- **Use Cases**: Particularly suitable for large code file structure analysis and batch processing scenarios
+
+---
+
 ## 🛠️ Core Features
 
 ### 📊 Code Structure Analysis
@@ -547,11 +564,16 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 - **Other MCP-compatible tools** - Universal MCP server
 
 ### 🌍 Multi-Language Support
-- **Java** - Full support (1103 lines of plugin), including Spring, JPA frameworks
-- **Python** - Full support (584 lines of plugin), including type annotations, decorators
-- **JavaScript** - Enterprise-grade support (1445 lines of plugin), including ES6+, React/Vue/Angular, JSX
-- **TypeScript** - **Complete support** (1553 lines of plugin), including interfaces, types, decorators, TSX/JSX, framework detection
-- **C/C++, Rust, Go** - Basic support
+
+| Programming Language | Support Level | Plugin Code Lines | Test Coverage | Key Features |
+|---------------------|---------------|-------------------|---------------|--------------|
+| **Java** | Full Support | 1,103 lines | 73.00% | Spring framework, JPA, enterprise features |
+| **Python** | Full Support | 584 lines | 63.26% | Type annotations, decorators, modern Python features |
+| **JavaScript** | Full Support | 1,445 lines | 68.31% | ES6+, React/Vue/Angular, JSX |
+| **TypeScript** | Full Support | 1,729 lines | 72.82% | Interfaces, types, decorators, TSX/JSX, framework detection |
+| **C/C++** | Basic Support | - | - | Basic syntax parsing |
+| **Rust** | Basic Support | - | - | Basic syntax parsing |
+| **Go** | Basic Support | - | - | Basic syntax parsing |
 
 ### 📁 Advanced File Search
 Powerful file discovery and content search based on fd and ripgrep:
@@ -570,16 +592,18 @@ Powerful file discovery and content search based on fd and ripgrep:
 ## 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **1,893 Tests** - 100% pass rate ✅
-- **71.48% Code Coverage** - Comprehensive test suite
+- **2,662 Tests** - 100% pass rate ✅
+- **79.16% Code Coverage** - Comprehensive test suite
 - **Zero Test Failures** - Production ready
 - **Cross-Platform Support** - Windows, macOS, Linux
 
-### ⚡ Latest Quality Achievements (v1.6.0)
+### ⚡ Latest Quality Achievements (v1.7.0)
+- ✅ **Token Saving Feature** - New suppress_output parameter automatically suppresses table output when file output is specified, saving AI token consumption
+- ✅ **Intelligent Output Control** - Automatically optimize response size when output_file is specified and suppress_output=true
+- ✅ **Enterprise-Grade Test Coverage** - Added 356 new test cases specifically for suppress_output functionality
+- ✅ **MCP Tools Enhancement** - Complete MCP server toolset supporting advanced file search and content analysis
 - ✅ **Cross-Platform Path Compatibility** - Fixed Windows short path names and macOS symlink differences
-- ✅ **Enterprise-Grade Reliability** - 50+ comprehensive test cases ensure stability
 - ✅ **GitFlow Implementation** - Professional development/release branch strategy
-- ✅ **AI Collaboration Optimization** - Specialized quality control for AI-assisted development
 
 ### ⚙️ Running Tests
 ```bash
@@ -595,22 +619,19 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 
 ### 📈 Test Coverage Details
 
-**Core Modules:**
-- **Language Detector**: 98.41% (Excellent) - Automatic programming language recognition
-- **CLI Main Entry**: 94.36% (Excellent) - Command-line interface
-- **Query Filter System**: 96.06% (Excellent) - Code query and filtering
-- **Query Service**: 86.25% (Good) - Query execution engine
-- **MCP Error Handling**: 82.76% (Good) - AI assistant integration error handling
-
-**Language Plugins:**
-- **Java Plugin**: 73.00% (Good) - 1103 lines of code, full enterprise-grade support
-- **JavaScript Plugin**: 68.31% (Good) - 1445 lines of code, modern ES6+ feature support
-- **Python Plugin**: 63.26% (Good) - 584 lines of code, full type annotation support
-
-**MCP Tools:**
-- **File Search Tool**: 88.77% (Excellent) - fd/ripgrep integration
-- **Content Search Tool**: 92.70% (Excellent) - Regular expression search
-- **Combined Search Tool**: 91.57% (Excellent) - Two-stage search
+| Module Category | Component | Coverage | Quality Level | Code Lines | Features |
+|-----------------|-----------|----------|---------------|------------|----------|
+| **Core Modules** | Language Detector | 98.41% | Excellent | - | Automatic programming language recognition |
+| | CLI Main Entry | 94.36% | Excellent | - | Command-line interface |
+| | Query Filter System | 96.06% | Excellent | - | Code query and filtering |
+| | Query Service | 86.25% | Good | - | Query execution engine |
+| | MCP Error Handling | 82.76% | Good | - | AI assistant integration error handling |
+| **Language Plugins** | Java Plugin | 80.30% | Excellent | 1333 | Full enterprise-grade support |
+| | JavaScript Plugin | 76.74% | Good | 1539 | Modern ES6+ feature support |
+| | Python Plugin | 82.84% | Excellent | 1296 | Full type annotation support |
+| **MCP Tools** | File Search Tool | 88.77% | Excellent | - | fd/ripgrep integration |
+| | Content Search Tool | 92.70% | Excellent | - | Regular expression search |
+| | Combined Search Tool | 91.57% | Excellent | - | Two-stage search |
 
 ### ✅ Documentation Verification Status
 

{tree_sitter_analyzer-1.6.2 → tree_sitter_analyzer-1.7.0}/README_ja.md

@@ -4,11 +4,11 @@
 
 [![Pythonバージョン](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![ライセンス](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![テスト](https://img.shields.io/badge/tests-2046%20passed-brightgreen.svg)](#品質保証)
-[![カバレッジ](https://img.shields.io/badge/coverage-69.67%25-green.svg)](#品質保証)
+[![テスト](https://img.shields.io/badge/tests-2662%20passed-brightgreen.svg)](#品質保証)
+[![カバレッジ](https://img.shields.io/badge/coverage-79.16%25-green.svg)](#品質保証)
 [![品質](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#品質保証)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
-[![バージョン](https://img.shields.io/badge/version-1.6.2-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![バージョン](https://img.shields.io/badge/version-1.7.0-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 AI時代のエンタープライズグレードコード解析ツール
@@ -56,15 +56,15 @@ Tree-sitter Analyzerは、AI時代のために設計されたエンタープラ
 - **統一要素システム** - 革新的な統一コード要素管理アーキテクチャ
 
 ### 🌍 エンタープライズグレードの多言語サポート
-- **Java** - 完全サポート（1103行のプラグインコード、73%カバレッジ）、Spring、JPAフレームワークを含む
-- **Python** - 完全サポート（584行のプラグインコード、63%カバレッジ）、型アノテーション、デコレータを含む
-- **JavaScript** - エンタープライズグレードサポート（1445行のプラグインコード、68%カバレッジ）、ES6+、React/Vue/Angular、JSXを含む
-- **TypeScript** - **完全サポート**（1553行のプラグインコード、29%カバレッジ）、インターフェース、型、デコレータ、TSX/JSX、フレームワーク検出を含む
+- **Java** - 完全サポート（1333行のプラグインコード、80.30%カバレッジ）、Spring、JPAフレームワークを含む
+- **Python** - 完全サポート（1296行のプラグインコード、82.84%カバレッジ）、型アノテーション、デコレータを含む
+- **JavaScript** - エンタープライズグレードサポート（1539行のプラグインコード、76.74%カバレッジ）、ES6+、React/Vue/Angular、JSXを含む
+- **TypeScript** - **完全サポート**（1729行のプラグインコード、72.82%カバレッジ）、インターフェース、型、デコレータ、TSX/JSX、フレームワーク検出を含む
 - **その他の言語** - C/C++、Rust、Goの基本サポート
 
 ### 🏆 本番環境対応
-- **2,046のテスト** - 100%合格率、エンタープライズグレードの品質保証
-- **69.67%カバレッジ** - 包括的なテストスイート
+- **2,662のテスト** - 100%合格率、エンタープライズグレードの品質保証
+- **79.16%カバレッジ** - 包括的なテストスイート
 - **クロスプラットフォームサポート** - Windows、macOS、Linuxとの完全な互換性
 - **継続的なメンテナンス** - アクティブな開発とコミュニティサポート
 
@@ -95,26 +95,15 @@ uv --version
 
 **fd**と**ripgrep**は、高度なMCP機能に使用される高性能なファイルおよびコンテンツ検索ツールです。
 
-```bash
-# macOS
-brew install fd ripgrep
-
-# Windows（wingetの使用を推奨）
-winget install sharkdp.fd BurntSushi.ripgrep.MSVC
-
-# Windows（その他の方法）
-# choco install fd ripgrep
-# scoop install fd ripgrep
-
-# Ubuntu/Debian
-sudo apt install fd-find ripgrep
-
-# CentOS/RHEL/Fedora
-sudo dnf install fd-find ripgrep
-
-# Arch Linux
-sudo pacman -S fd ripgrep
-```
+| オペレーティングシステム | パッケージマネージャー | インストールコマンド | 備考 |
+|------------------------|---------------------|-------------------|------|
+| **macOS** | Homebrew | `brew install fd ripgrep` | 推奨方法 |
+| **Windows** | winget | `winget install sharkdp.fd BurntSushi.ripgrep.MSVC` | 推奨方法 |
+| | Chocolatey | `choco install fd ripgrep` | 代替方法 |
+| | Scoop | `scoop install fd ripgrep` | 代替方法 |
+| **Ubuntu/Debian** | apt | `sudo apt install fd-find ripgrep` | 公式リポジトリ |
+| **CentOS/RHEL/Fedora** | dnf | `sudo dnf install fd-find ripgrep` | 公式リポジトリ |
+| **Arch Linux** | pacman | `sudo pacman -S fd ripgrep` | 公式リポジトリ |
 
 **インストールの確認：**
 ```bash
@@ -519,6 +508,34 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 
 ---
 
+## 🤖 MCP完全ツールリスト
+
+Tree-sitter AnalyzerはAIアシスタント向けに設計された豊富なMCPツールセットを提供します：
+
+| ツールカテゴリ | ツール名 | 主要機能 | コア特性 |
+|-------------|---------|---------|---------|
+| **📊 コード解析** | `analyze_code_structure` | コード構造解析とテーブル生成 | 🆕 suppress_outputパラメータ、複数フォーマット(full/compact/csv/json)、自動言語検出 |
+| | `check_code_scale` | コードファイル規模の高速解析 | ファイルサイズ統計、行数統計、複雑度解析、パフォーマンス指標 |
+| | `extract_code_section` | 正確なコードセクション抽出 | 指定行範囲抽出、大ファイル効率処理、元フォーマット保持 |
+| **🔍 インテリジェント検索** | `list_files` | 高性能ファイル発見 | fdベース、globパターン、ファイルタイプフィルタ、時間範囲制御 |
+| | `search_content` | 正規表現コンテンツ検索 | ripgrepベース、複数出力フォーマット、コンテキスト制御、エンコーディング処理 |
+| | `find_and_grep` | 2段階検索 | ファイル発見→コンテンツ検索、fd+ripgrep組み合わせ、インテリジェントキャッシュ最適化 |
+| **🔧 高度なクエリ** | `query_code` | tree-sitterクエリ | 事前定義クエリキー、カスタムクエリ文字列、フィルタ式サポート |
+| **⚙️ システム管理** | `set_project_path` | プロジェクトルートパス設定 | セキュリティ境界制御、自動パス検証 |
+| **📁 リソースアクセス** | コードファイルリソース | URIコードファイルアクセス | URI識別によるファイルコンテンツアクセス |
+| | プロジェクト統計リソース | プロジェクト統計データアクセス | プロジェクト解析データと統計情報 |
+
+### 🆕 v1.7.0新機能：suppress_output機能
+
+`analyze_code_structure`ツールに新しく追加された`suppress_output`パラメータは、革命的なトークン最適化機能です：
+
+- **問題解決**：解析結果が大きすぎる場合、従来の方式では完全なテーブルデータを返し、大量のトークンを消費
+- **インテリジェント最適化**：`suppress_output=true`かつ`output_file`指定時、基本メタデータのみを返却
+- **顕著な効果**：レスポンスサイズを最大99%削減、AIダイアログのトークン消費を大幅節約
+- **使用シーン**：大型コードファイルの構造解析やバッチ処理シーンに特に適している
+
+---
+
 ## 🛠️ コア機能
 
 ### 📊 コード構造解析
@@ -547,11 +564,16 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 - **その他のMCP互換ツール** - ユニバーサルMCPサーバー
 
 ### 🌍 多言語サポート
-- **Java** - 完全サポート（1103行のプラグイン）、Spring、JPAフレームワークを含む
-- **Python** - 完全サポート（584行のプラグイン）、型アノテーション、デコレータを含む
-- **JavaScript** - エンタープライズグレードサポート（1445行のプラグイン）、ES6+、React/Vue/Angular、JSXを含む
-- **TypeScript** - **完全サポート**（1553行のプラグイン）、インターフェース、型、デコレータ、TSX/JSX、フレームワーク検出を含む
-- **C/C++、Rust、Go** - 基本サポート
+
+| プログラミング言語 | サポートレベル | プラグインコード行数 | テストカバレッジ | 主要機能 |
+|------------------|---------------|-------------------|----------------|---------|
+| **Java** | 完全サポート | 1,333行 | 80.30% | Springフレームワーク、JPA、エンタープライズ機能 |
+| **Python** | 完全サポート | 1,296行 | 82.84% | 型アノテーション、デコレータ、モダンPython機能 |
+| **JavaScript** | 完全サポート | 1,539行 | 76.74% | ES6+、React/Vue/Angular、JSX |
+| **TypeScript** | 完全サポート | 1,729行 | 72.82% | インターフェース、型、デコレータ、TSX/JSX、フレームワーク検出 |
+| **C/C++** | 基本サポート | - | - | 基本構文解析 |
+| **Rust** | 基本サポート | - | - | 基本構文解析 |
+| **Go** | 基本サポート | - | - | 基本構文解析 |
 
 ### 📁 高度なファイル検索
 fdとripgrepに基づく強力なファイル検出とコンテンツ検索：
@@ -570,16 +592,18 @@ fdとripgrepに基づく強力なファイル検出とコンテンツ検索：
 ## 🏆 品質保証
 
 ### 📊 品質メトリクス
-- **1,893のテスト** - 100%合格率 ✅
-- **71.48%コードカバレッジ** - 包括的なテストスイート
+- **2,662のテスト** - 100%合格率 ✅
+- **79.16%コードカバレッジ** - 包括的なテストスイート
 - **ゼロテスト失敗** - 本番環境対応
 - **クロスプラットフォームサポート** - Windows、macOS、Linux
 
-### ⚡ 最新の品質成果（v1.6.2）
+### ⚡ 最新の品質成果（v1.7.0）
+- ✅ **トークン節約機能** - 新しいsuppress_outputパラメータで、ファイル出力時にテーブル出力を自動抑制し、AIトークン消費を節約
+- ✅ **インテリジェント出力制御** - output_file指定時かつsuppress_output=trueの場合、レスポンスサイズを自動最適化
+- ✅ **エンタープライズグレードテストカバレッジ** - suppress_output機能専用の356個の新しいテストケースを追加
+- ✅ **MCPツール強化** - 高度なファイル検索とコンテンツ解析をサポートする完全なMCPサーバーツールセット
 - ✅ **クロスプラットフォームパス互換性** - Windowsの短いパス名とmacOSのシンボリックリンクの違いを修正
-- ✅ **エンタープライズグレードの信頼性** - 50以上の包括的なテストケースで安定性を確保
 - ✅ **GitFlow実装** - プロフェッショナルな開発/リリースブランチ戦略
-- ✅ **AIコラボレーション最適化** - AI支援開発のための専門的な品質管理
 
 ### ⚙️ テストの実行
 ```bash
@@ -595,22 +619,19 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 
 ### 📈 テストカバレッジの詳細
 
-**コアモジュール：**
-- **言語検出器**: 98.41%（優秀） - 自動プログラミング言語認識
-- **CLIメインエントリ**: 94.36%（優秀） - コマンドラインインターフェース
-- **クエリフィルタシステム**: 96.06%（優秀） - コードクエリとフィルタリング
-- **クエリサービス**: 86.25%（良好） - クエリ実行エンジン
-- **MCPエラー処理**: 82.76%（良好） - AIアシスタント統合エラー処理
-
-**言語プラグイン：**
-- **Javaプラグイン**: 73.00%（良好） - 1103行のコード、完全なエンタープライズグレードサポート
-- **JavaScriptプラグイン**: 68.31%（良好） - 1445行のコード、モダンなES6+機能サポート
-- **Pythonプラグイン**: 63.26%（良好） - 584行のコード、完全な型アノテーションサポート
-
-**MCPツール：**
-- **ファイル検索ツール**: 88.77%（優秀） - fd/ripgrep統合
-- **コンテンツ検索ツール**: 92.70%（優秀） - 正規表現検索
-- **組み合わせ検索ツール**: 91.57%（優秀） - 2段階検索
+| モジュールカテゴリ | モジュール名 | カバレッジ | 品質レベル | 主要機能 |
+|------------------|-------------|-----------|-----------|---------|
+| **🔧 コアモジュール** | 言語検出器 | 98.41% | 優秀 | 自動プログラミング言語認識 |
+| | CLIメインエントリ | 94.36% | 優秀 | コマンドラインインターフェース |
+| | クエリフィルタシステム | 96.06% | 優秀 | コードクエリとフィルタリング |
+| | クエリサービス | 86.25% | 良好 | クエリ実行エンジン |
+| | MCPエラー処理 | 82.76% | 良好 | AIアシスタント統合エラー処理 |
+| **🌍 言語プラグイン** | Javaプラグイン | 73.00% | 良好 | 1103行のコード、完全なエンタープライズグレードサポート |
+| | JavaScriptプラグイン | 68.31% | 良好 | 1445行のコード、モダンなES6+機能サポート |
+| | Pythonプラグイン | 63.26% | 良好 | 584行のコード、完全な型アノテーションサポート |
+| **🤖 MCPツール** | ファイル検索ツール | 88.77% | 優秀 | fd/ripgrep統合 |
+| | コンテンツ検索ツール | 92.70% | 優秀 | 正規表現検索 |
+| | 組み合わせ検索ツール | 91.57% | 優秀 | 2段階検索 |
 
 ### ✅ ドキュメント検証ステータス