TSAP MCP Server
2025.04.07
1
HTML文本搜索代码分析文档处理AI 工具集成开发效率
TSAP MCP Server 是一个基于 Model Context Protocol (MCP) 标准的实现，专注于文本搜索和分析处理（TSAP），为代码智能和文本分析提供高级功能。它作为一个独立的服务器运行，通过 MCP 接口暴露广泛的功能，兼容 Claude Desktop 和其他 MCP 兼容客户端。该服务器基于 MCP Python SDK，利用多种专用库，为 AI 助手提供丰富的文本、代码和文档分析能力。
View on GitHub
Overview
基本能力
产品定位
TSAP MCP Server 是一个专注于文本搜索和分析处理的服务器，通过 MCP 协议为 AI 助手提供代码智能和文本分析功能。
核心功能
- MCP 协议实现：完全符合 Model Context Protocol 标准。
- 搜索能力：支持文本搜索（正则表达式、大小写敏感、路径过滤）、代码搜索（ripgrep）、语义搜索（Nomic 和 sentence-transformers 嵌入模型）。
- 处理工具：文本标准化和转换、基于模式的数据提取、文档结构分析。
- 分析工具：代码质量和结构分析、文本内容分析、文档分析和元数据提取。
- 可视化工具：使用 matplotlib 进行数据可视化，使用 networkx 进行网络可视化。
- 资源访问：文件内容访问、项目结构信息、配置管理、语义语料库管理。
- Claude Desktop 集成：通过 MCP 协议与 Claude Desktop 无缝集成。
适用场景
- 代码搜索和分析
- 文本处理和模式提取
- 文档结构分析和元数据提取
- AI 助手的代码智能支持
- 开发环境中的文本和代码分析
工具列表
tsap：核心文本搜索和分析处理系统，提供代码和文本搜索、文档分析、模式提取、数据处理、进化算法、存储和缓存等功能。toolapi：内部 API 系统，定义工具交互协议，处理工具请求/响应生命周期，管理工具注册和发现，提供客户端库。tsap_mcp：MCP 适配层，将核心 TSAP 功能包装为 MCP 兼容接口，映射 TSAP 工具到 MCP 工具函数，实现 MCP URI 模式的资源处理程序，提供 MCP 提示模板。
常见问题解答
- 如何安装？：需要 Python 3.13 或更高版本，以及 ripgrep（用于代码搜索功能）。
- 如何运行服务器？：使用
tsap-mcp run命令，可以指定主机和端口。 - 如何调试？：使用
tsap-mcp run --reload启用自动重载，或使用 MCP Inspector 进行开发和调试。
使用教程
使用依赖
- Python 3.13 或更高版本
- ripgrep（用于代码搜索功能）
安装教程
# 克隆仓库
git clone https://github.com/your-org/tsap-mcp.git
cd tsap-mcp
# 安装包
pip install -e .
# 安装所有可选依赖（可视化、语义搜索等）
pip install -e ".[all]"
# 为 Claude Desktop 安装服务器
tsap-mcp install --desktop
调试方式
# 运行服务器并启用自动重载
tsap-mcp run --reload
# 使用 MCP Inspector 进行调试
pip install mcp[cli]
mcp dev src/tsap_mcp/server.py