TSAP MCP

TSAP MCP服务器

用于代码智能和文本分析的文本搜索和分析处理（TSAP）服务器的模型上下文协议（MCP）实现。

目录

• TSAP MCP服务器

- 概述 - 项目组成部分 - 特性 - 安装 - 用法 - 建筑 - 发展 - 贡献 - 许可证

概述

TSAP MCP Server是模型上下文协议（MCP）标准的实现，提供高级文本搜索、处理和分析功能。它作为一个独立的服务器运行，通过MCP接口提供广泛的功能，使其与Claude Desktop和其他MCP兼容的客户端兼容。

该服务器基于MCP Python SDK构建，并利用了一组多样化的专用库，使AI助手能够通过标准化接口处理文本、代码和文档分析。

项目组成部分

该项目由三个主要部分组成，它们协同工作：

1. tsap核心文本搜索和分析处理系统提供以下基本功能：

- 代码和文本搜索 - 文献分析 - 模式提取 - 数据处理 - 进化算法 - 存储和缓存

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

1. toolapi：内部API系统 tsap 即：

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

这 toolapi 用作对TSAP功能进行编程访问的原始API层。

1. tsap_mcp：模型上下文协议适配器层：

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

这些组件共同创建了一个强大的系统，其中核心TSAP功能通过标准化的MCP接口公开，使其能够与支持模型上下文协议的Claude Desktop和其他AI助手无缝集成。

特性

• MCP协议实现：完全符合AI工具的模型上下文协议标准。

• 搜索功能:

- 支持正则表达式、区分大小写选项和路径过滤的文本搜索 - 使用带有模式匹配和文件过滤的ripgrep进行代码搜索 - 使用Nomic和句子变换器的嵌入模型进行语义搜索

• 处理工具:

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

• 分析工具:

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

• 可视化工具:

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

• 资源访问:

- 基于路径检索的文件内容访问 - 项目结构信息 - 配置管理 - 语义语料库管理

• Claude桌面集成:

- 通过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桌面集成

要安装与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：性能模式（平衡、速度、精度）
• TSAP_CACHE_ENABLED：启用缓存（默认值：true）
• TSAP_DEBUG：启用调试模式（默认值：false）

建筑

TSAP MCP服务器遵循围绕核心组件组织的模块化架构：

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. 通过以下方式将结果转换回MCP兼容的响应 tsap_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检查员

对于开发和调试，您可以使用MCP检查器：

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

贡献

欢迎投稿！请看 贡献.md 作为指导方针。

许可证

该项目根据麻省理工学院许可证（使用OpenAI/Anthropic Rider）获得许可-请参阅 许可证 文件以获取详细信息。