TSAP MCP服务器
用于代码智能和文本分析的文本搜索和分析处理（TSAP）服务器的模型上下文协议（MCP）实现。
目录
- 概述 - 项目组成部分 - 特性 - 安装 - 用法 - 建筑 - 发展 - 贡献 - 许可证
概述
TSAP MCP Server是模型上下文协议（MCP）标准的实现，提供高级文本搜索、处理和分析功能。它作为一个独立的服务器运行，通过MCP接口提供广泛的功能，使其与Claude Desktop和其他MCP兼容的客户端兼容。
该服务器基于MCP Python SDK构建，并利用了一组多样化的专用库，使AI助手能够通过标准化接口处理文本、代码和文档分析。
项目组成部分
该项目由三个主要部分组成，它们协同工作：
tsap核心文本搜索和分析处理系统提供以下基本功能：
- 代码和文本搜索 - 文献分析 - 模式提取 - 数据处理 - 进化算法 - 存储和缓存
该组件实现了系统的核心功能和业务逻辑。
toolapi：内部API系统tsap即：
- 定义工具交互协议 - 处理工具请求/响应生命周期 - 管理工具注册和发现 - 为工具使用提供客户端库
这 toolapi 用作对TSAP功能进行编程访问的原始API层。
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数据流
系统中的数据流遵循以下模式：
- MCP客户端（如Claude Desktop）向
tsap_mcp服务器 - 这
tsap_mcp适配器层将MCP请求转换为适当的tsap操作 - 这
tsap核心系统处理请求，可能使用其toolapi子系统 - 通过以下方式将结果转换回MCP兼容的响应
tsap_mcp - MCP客户端接收并处理响应
MCP组件
服务器实现了三种MCP组件类型：
- 工具：可以调用以执行特定操作的函数
- 资源：通过基于URI的接口的数据访问模式
- 提示：用于常见交互的可重用模板
发展
开发环境设置
# 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 --reloadMCP检查员
对于开发和调试，您可以使用MCP检查器：
pip install mcp[cli]
mcp dev src/tsap_mcp/server.py贡献
欢迎投稿！请看 贡献.md 作为指导方针。
许可证
该项目根据麻省理工学院许可证（使用OpenAI/Anthropic Rider）获得许可-请参阅 许可证 文件以获取详细信息。