TSAP MCP 服务器

一个用于代码智能和文本分析的文本搜索与分析处理 (TSAP) 服务器的 Model Context Protocol (MCP) 实现。

目录

• TSAP MCP 服务器
  • 概述
  • 项目组件
  • 特性
  • 安装
  • 使用
  • 架构
  • 开发
  • 贡献
  • 许可证

概述

TSAP MCP 服务器是 Model Context Protocol (MCP) 标准的实现，它提供了高级的文本搜索、处理和分析能力。它作为一个独立的服务器运行，通过 MCP 接口暴露了广泛的功能，使其与 Claude Desktop 和其他 MCP 兼容的客户端兼容。

该服务器构建在 MCP Python SDK 之上，并利用了一组多样化的专用库，通过标准化接口为 AI 助手提供了处理文本、代码和文档分析的丰富能力。

项目组件

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

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

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

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

2. toolapi: tsap 内部的 API 系统，它：

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

   toolapi 作为原始 API 层，用于以编程方式访问 TSAP 功能。

3. tsap_mcp: Model Context Protocol 适配器层，它：

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

这些组件共同创建了一个强大的系统，其中核心 TSAP 功能通过标准化的 MCP 接口暴露，使其能够与 Claude Desktop 和其他支持 Model Context Protocol 的 AI 助手无缝集成。

特性

• MCP 协议实现: 完全符合 AI 工具的 Model Context Protocol 标准。

• 搜索能力:

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

• 处理工具:

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

• 分析工具:

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

• 可视化工具:

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

• 资源访问:

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

• Claude Desktop 集成:

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

安装

前提条件

• 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 集成

要安装服务器以与 Claude Desktop 一起使用：

tsap-mcp install --desktop

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

使用

运行服务器

# 使用默认设置运行（localhost:8000）
tsap-mcp run

# 指定主机和端口
tsap-mcp run --host 0.0.0.0 --port 9000

# 启用自动重新加载以进行开发
tsap-mcp run --reload

# 禁用适配器层
tsap-mcp run --no-adapter

服务器信息

# 显示基本服务器信息
tsap-mcp info

# 显示所有已注册的组件（工具、资源、提示）
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 服务器遵循围绕核心组件组织的模块化架构：

src/
├── tsap/                  # 核心 TSAP 实现
│   ├── __init__.py        # 包初始化
│   ├── server.py          # 主服务器实现
│   ├── cli.py             # 命令行界面
│   ├── config.py          # 配置管理
│   ├── main.py            # 主入口点
│   ├── api/               # API 层
│   ├── analysis/          # 文本和代码分析
│   ├── core/              # 核心功能
│   ├── project/           # 项目管理
│   ├── storage/           # 存储实用程序
│   ├── utils/             # 实用函数
│   ├── toolapi/           # 工具 API 协议实现
│   │   ├── __init__.py    # 包初始化
│   │   ├── handler.py     # 工具请求处理
│   │   ├── models.py      # 数据模型
│   │   ├── protocol.py    # 协议定义
│   │   └── client/        # 客户端库
│   └── ...                # 其他 TSAP 组件
│
├── tsap_mcp/              # MCP 适配器层
│   ├── __init__.py        # 包初始化
│   ├── server.py          # MCP 服务器实现
│   ├── cli.py             # 命令行界面
│   ├── adapter.py         # 原始 TSAP 的适配器
│   ├── tool_map.py        # 工具映射实用程序
│   ├── lifespan.py        # 服务器生命周期管理
│   ├── tools/             # MCP 工具实现
│   │   ├── search.py      # 搜索工具
│   │   ├── processing.py  # 文本处理工具
│   │   ├── analysis.py    # 分析工具
│   │   ├── visualization.py # 可视化工具
│   │   └── composite.py   # 复合工具
│   ├── resources/         # MCP 资源实现
│   │   ├── files.py       # 文件访问资源
│   │   ├── project.py     # 项目结构资源
│   │   ├── config.py      # 配置资源
│   │   └── semantic.py    # 语义语料库资源
│   ├── prompts/           # MCP 提示实现
│   └── adapters/          # 协议适配器
│
├── scripts/               # 实用程序脚本
└── tests/                 # 测试套件

数据流

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

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. 提示: 用于常见交互的可重用模板

开发

开发环境设置

# 克隆仓库
git clone https://github.com/your-org/tsap-mcp.git
cd tsap-mcp

# 以开发模式安装，并包含开发依赖项
pip install -e ".[dev]"

# 运行测试
pytest

以开发模式运行

# 运行并自动重新加载
tsap-mcp run --reload

MCP 检查器

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

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

贡献

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

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。