TSAP MCP Server

TSAP MCP 服务

Text Search and Analysis Processing（TSAP）的 Model Context Protocol（MCP）实现，用于代码智能和文本分析。

目录

• TSAP MCP 服务
  • 概述
  • 项目组件
  • 功能
  • 安装
  • 用法
  • 架构
  • 开发
  • 贡献
  • 许可证

概述

TSAP MCP 服务是 Model Context Protocol（MCP）标准的一种实现，可提供高级文本搜索、处理和分析能力。它作为独立服务运行，通过 MCP 接口提供广泛的功能，因此兼容 Claude Desktop 和其他兼容 MCP 的客户端。

此服务基于 MCP Python SDK 构建，并利用多种专业库，通过标准化接口为 AI 助手提供丰富的文本、代码和文档分析能力。

项目组件

本项目由三个协同工作的主要组件构成：

1. tsap：核心 Text Search and Analysis Processing 系统，提供以下基础能力：

   • 代码和文本搜索
   • 文档分析
   • 模式提取
   • 数据处理
   • 演化算法
   • 存储和缓存

   此组件实现系统的核心功能和业务逻辑。

2. toolapi：tsap 中的内部 API 系统，负责：

   • 定义工具交互协议
   • 处理工具请求/响应生命周期
   • 管理工具注册和发现
   • 提供用于使用工具的客户端库

   toolapi 是以编程方式访问 TSAP 功能的原始 API 层。

3. tsap_mcp：Model Context Protocol 适配层，负责：

   • 将核心 TSAP 功能封装为兼容 MCP 的接口
   • 将 TSAP 工具映射到 MCP 工具函数
   • 为 MCP URI 模式实现资源处理程序
   • 提供 MCP 提示词模板
   • 充当 TSAP 与 Claude Desktop（或其他 MCP 客户端）之间的桥梁

这些组件共同构成了一个强大的系统，通过标准化的 MCP 接口提供核心 TSAP 功能，可轻松集成到 Claude Desktop 及其他支持 Model Context Protocol 的 AI 助手中。

功能

• MCP 协议实现：完全符合 Model Context Protocol 标准，支持 AI 工具。

• 搜索能力：

  • 支持正则表达式、区分大小写选项和路径筛选的文本搜索
  • 使用 ripgrep 进行代码搜索，支持模式匹配和文件筛选
  • 使用 Nomic 和 sentence-transformers 的嵌入模型进行语义搜索

• 处理工具：

  • 文本规范化和转换
  • 基于模式的数据提取
  • 文档结构分析

• 分析工具：

  • 代码质量和结构分析
  • 文本内容分析
  • 文档概况分析和元数据提取

• 可视化工具：

  • 使用 matplotlib 进行数据可视化
  • 使用 networkx 进行网络可视化

• 资源访问：

  • 根据路径访问文件内容
  • 项目结构信息
  • 配置管理
  • 语义语料库管理

• Claude Desktop 集成：

  • 通过 MCP 协议与 Claude Desktop 无缝集成

安装

前提条件

• Python 3.13 或更高版本
• 系统已安装 ripgrep（用于代码搜索功能）

从源代码安装

# Clone the repository
git clone https://github.com/your-org/tsap-mcp.git
cd tsap-mcp

# Install the package
pip install -e .

# For all optional dependencies (visualization, semantic search, etc.)
pip install -e ".[all]"

Claude Desktop 集成

要安装此服务以便与 Claude Desktop 配合使用：

tsap-mcp install --desktop

这会将服务注册到 Claude Desktop，使其可在对话中使用。

用法

运行服务

# Run with default settings (localhost:8000)
tsap-mcp run

# Specify host and port
tsap-mcp run --host 0.0.0.0 --port 9000

# Enable auto-reload for development
tsap-mcp run --reload

# Disable adapter layer
tsap-mcp run --no-adapter

服务信息

# Show basic server information
tsap-mcp info

# Show all registered components (tools, resources, prompts)
tsap-mcp info --components

命令行选项

该服务支持多种命令行选项：

tsap-mcp run [-H HOST] [-p PORT] [--reload] [--no-adapter]
tsap-mcp info [--components]
tsap-mcp test [--compatibility]
tsap-mcp install [--desktop] [--system]

环境变量

可以使用以下环境变量配置服务行为：

• TSAP_HOST：绑定的主机（默认值：127.0.0.1）
• TSAP_PORT：绑定的端口（默认值：8000）
• TSAP_LOG_LEVEL：日志级别（默认值：INFO）
• TSAP_PERFORMANCE_MODE：性能模式（balanced、speed、accuracy）
• TSAP_CACHE_ENABLED：启用缓存（默认值：true）
• TSAP_DEBUG：启用调试模式（默认值：false）

架构

TSAP MCP Server 采用模块化架构，围绕核心组件组织：

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            # Main entry point
│   ├── api/               # API layer 
│   ├── analysis/          # Text and code analysis
│   ├── core/              # Core functionality
│   ├── project/           # Project management
│   ├── storage/           # Storage utilities
│   ├── utils/             # Utility functions
│   ├── toolapi/           # Tool API protocol implementation
│   │   ├── __init__.py    # Package initialization
│   │   ├── handler.py     # Tool request handling
│   │   ├── models.py      # Data models
│   │   ├── protocol.py    # Protocol definition
│   │   └── client/        # Client libraries
│   └── ...                # Other TSAP components
│
├── tsap_mcp/              # MCP adapter layer
│   ├── __init__.py        # Package initialization
│   ├── server.py          # MCP server implementation
│   ├── cli.py             # Command-line interface
│   ├── adapter.py         # Adapter for original TSAP
│   ├── tool_map.py        # Tool mapping utilities
│   ├── lifespan.py        # Server lifecycle management
│   ├── tools/             # MCP tool implementations
│   │   ├── search.py      # Search tools
│   │   ├── processing.py  # Text processing tools
│   │   ├── analysis.py    # Analysis tools
│   │   ├── visualization.py # Visualization tools
│   │   └── composite.py   # Composite tools
│   ├── resources/         # MCP resource implementations
│   │   ├── files.py       # File access resources
│   │   ├── project.py     # Project structure resources
│   │   ├── config.py      # Configuration resources
│   │   └── semantic.py    # Semantic corpus resources
│   ├── prompts/           # MCP prompt implementations
│   └── adapters/          # Protocol adapters
│
├── scripts/               # Utility scripts
└── tests/                 # Test suite

数据流

系统中的数据流遵循以下模式：

1. MCP 客户端（例如 Claude Desktop）向 tsap_mcp 服务发送请求
2. tsap_mcp 适配层将 MCP 请求转换为相应的 tsap 操作
3. tsap 核心系统处理请求，可能会使用其 toolapi 子系统
4. tsap_mcp 将结果转换回兼容 MCP 的响应
5. MCP 客户端接收并处理响应

MCP 组件

该服务实现了三种 MCP 组件类型：

1. 工具：可调用以执行特定操作的函数
2. 资源：通过基于 URI 的接口访问数据的方式
3. 提示词：用于常见交互的可复用模板

开发

开发环境设置

# Clone the repository
git clone https://github.com/your-org/tsap-mcp.git
cd tsap-mcp

# Install in development mode with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

在开发模式下运行

# Run with auto-reload
tsap-mcp run --reload

MCP Inspector

在开发和调试时，可以使用 MCP Inspector：

pip install mcp[cli]
mcp dev src/tsap_mcp/server.py

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解相关指南。

许可证

本项目采用 MIT License（附带 OpenAI/Anthropic Rider）许可，详情请参阅 LICENSE 文件。