Tsap MCP Server

🚀 TSAP MCP Server

The TSAP MCP Server is a core component based on the MCP protocol, designed for text analysis and processing tasks. It provides a unified interface to support multiple functions including file access, project management, configuration management, and semantic data retrieval.

🚀 Quick Start

Starting the Server

1. Basic Startup:

   tsap-mcp run
   

2. Development Mode (Auto Reload):

   tsap-mcp run --reload
   

3. Test Compatibility:

   tsap-mcp test --compatibility
   

4. Install to System or Desktop Environment:

   tsap-mcp install [--system] [--desktop]
   

✨ Features

The TSAP MCP Server supports various functions such as file access, project management, configuration management, and semantic data retrieval through a unified interface.

📦 Installation

Installation Steps

1. Clone the repository:

   git clone https://github.com/your-org/tsap-mcp.git
   cd tsap-mcp
   

2. Install in development mode (optional development dependencies):

   pip install -e ".[dev]"
   

3. Run tests:

   pytest
   

💻 Usage Examples

Server Configuration

The server's behavior can be configured via the following environment variables:

📚 Documentation

Server Architecture

Module Structure

src/
├── tsap/                  # Core TSAP implementation
│   ├── __init__.py        # Package initialization
│   ├── server.py          # Main server implementation
│   ├── cli.py             # Command-line interface
│   ├── config.py          # Configuration management
│   ├── main.py            # Entry point
│   ├── api/               # API layer 
│   ├── analysis/          # Text and code analysis
│   ├── core/              # Core functions
│   ├── project/           # Project management
│   ├── storage/           # Storage tools
│   ├── utils/             # Utility functions
│   ├── toolapi/           # Tool API protocol implementation
│   │   ├── __init__.py    # Package initialization
│   │   ├── server.py      # Server implementation
│   │   ├── client.py      # Client implementation
│   │   └── protocol.py    # Protocol definition
│   └── mcp/              # MCP protocol implementation
├── tsap-mcp/             # MCP server main directory
│   ├── __init__.py       # Package initialization
│   ├── server.py          # Server implementation
│   ├── cli.py             # Command-line interface
│   └── config.py          # Configuration management
└── tests/                # Test cases
   └── test_*.py           # Test cases for each component

Data Flow

1. Request Handling:

   • The client sends a request to the server.
   • The server parses and validates the request.
   • Calls the corresponding processing logic based on the functional module.

2. Core Process:

   Client → Parser → Validator → Processor → Response Generator → Client
   

3. Component Interaction:

   • toolapi: Responsible for communication between tools.
   • mcp: Implements the MCP protocol interface.
   • storage: Manages data storage.

Development Environment

Project Initialization

1. Clone the repository:

   git clone https://github.com/your-org/tsap-mcp.git
   cd tsap-mcp
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Start the development server:

   tsap-mcp run --reload
   

Contribution Guidelines

1. Code Submission Specification:

   • Follow the PEP8 code style.
   • Provide detailed commit messages.

2. Issue Reporting:

   • Submit issues to the GitHub repository: https://github.com/your-org/tsap-mcp/issues

3. Contribute Code:

   • Fork the project.
   • Create a feature branch.
   • Submit a Pull Request.

Architectural Design

Module Division

• toolapi: Responsible for implementing the communication protocol between tools.
• mcp: Implements the core MCP protocol interface.
• storage: Provides data storage and retrieval functions.
• project: Manages project-related configurations and operations.

Data Flow Design

1. Request Handling Process:

   Client → Parser → Validator → Processor → Response Generator → Client
   

2. Core Component Interaction:

   • toolapi is responsible for communication between tools.
   • mcp implements the MCP protocol interface.
   • storage manages data storage.

Appendix

References

• MCP Protocol Specification
• Related Project Documentation

License

This project is licensed under the MIT License.

Contribution Guidelines

If you want to contribute code or report issues, please refer to the CONTRIBUTING.md file.