TSAP MCP Server

TSAP MCP サーバー

コードインテリジェンスとテキスト分析のための、テキスト検索・分析処理（TSAP）サーバーの Model Context Protocol（MCP）実装です。

目次

• TSAP MCP サーバー
  • 概要
  • プロジェクトのコンポーネント
  • 機能
  • インストール
  • 使用方法
  • アーキテクチャ
  • 開発
  • コントリビューション
  • ライセンス

概要

TSAP MCP サーバーは、高度なテキスト検索、処理、分析機能を提供する Model Context Protocol（MCP）標準の実装です。幅広い機能をMCPインターフェース経由で公開するスタンドアロンサーバーとして動作し、Claude Desktopやその他のMCP対応クライアントと互換性があります。

MCP Python SDKを基盤とし、多様な専門ライブラリを活用するこのサーバーは、標準化されたインターフェースを通じて、テキスト、コード、ドキュメントの分析に取り組むための豊富な機能をAIアシスタントに提供します。

プロジェクトのコンポーネント

このプロジェクトは、連携して動作する3つの主要コンポーネントで構成されています。

1. tsap：次の基本機能を提供する、中核となるテキスト検索・分析処理システムです。

   • コードとテキストの検索
   • ドキュメント分析
   • パターン抽出
   • データ処理
   • 進化的アルゴリズム
   • ストレージとキャッシュ

   このコンポーネントは、システムの中核機能とビジネスロジックを実装します。

2. toolapi：tsap 内部のAPIシステムで、次の機能を備えています。

   • ツールの対話プロトコルを定義する
   • ツールのリクエスト／レスポンスのライフサイクルを処理する
   • ツールの登録と検出を管理する
   • ツールを利用するためのクライアントライブラリを提供する

   toolapi は、TSAPの機能にプログラムからアクセスするための元のAPIレイヤーです。

3. tsap_mcp：Model Context Protocolアダプターレイヤーで、次の機能を備えています。

   • TSAPの中核機能をMCP互換インターフェースでラップする
   • TSAPのツールをMCPツール関数に対応付ける
   • MCP URIパターン用のリソースハンドラーを実装する
   • MCPプロンプトテンプレートを提供する
   • TSAPとClaude Desktop（またはその他のMCPクライアント）をつなぐ

これらのコンポーネントが連携することで、TSAPの中核機能を標準化されたMCPインターフェース経由で公開する強力なシステムが実現します。Model Context Protocolに対応するClaude Desktopやその他のAIアシスタントと、シームレスに統合できます。

機能

• MCPプロトコルの実装：AIツール標準のModel Context Protocolに完全準拠しています。

• 検索機能：

  • 正規表現への対応、大文字と小文字の区別オプション、パスフィルタリングを備えたテキスト検索
  • パターンマッチングとファイルフィルタリングを備え、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 コンポーネント

サーバーは、次の 3 種類の 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 ファイルをご覧ください。