Senso API MCP Server

Senso API MCP サーバー

Senso API 向けの Model Context Protocol（MCP）サーバー実装です。Claude Desktop を通じて、Claude が Senso のナレッジベースを操作できるようにします。

このサーバーを使うと、Claude は次の操作を行えます。

• 生のコンテンツをナレッジベースに追加する
• 既存のコンテンツを検索する
• ナレッジベースに基づいて新しいコンテンツを生成する

前提条件

• Python 3.12 以上
• uv — 高速な Python パッケージインストーラー兼リゾルバー
• Claude Desktop アプリケーション

インストール

1. このリポジトリをクローンします。

   git clone [email protected]:AI-Template-SDK/api-mcp-server.git
   cd api-mcp-server
   

2. uv を使って仮想環境を作成し、依存関係をインストールします。

   # Create and activate virtual environment
   uv venv
   
   # On macOS/Linux
   source .venv/bin/activate
   
   # On Windows
   .venv\Scripts\activate
   
   # Install dependencies from pyproject.toml
   uv pip install -e .
   

設定

API キー

このサーバーは認証に Senso API キーを使用します。server.py ファイル内の API キーを編集する必要があります。

1. テキストエディターで server.py を開きます
2. 次の行を探します。API_KEY = "tgr_YOUR_API_KEY"
3. お使いの Senso API キーに置き換えます

Claude Desktop の設定

この MCP サーバーを Claude Desktop で使うには、Claude の設定に追加する必要があります。

1. Claude Desktop の設定ファイルを探すか、作成します。

   • macOS の場合：

     mkdir -p ~/Library/Application\ Support/Claude
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     

   • Windows の場合：

     if (-not (Test-Path $env:AppData\Claude)) { mkdir $env:AppData\Claude }
     code $env:AppData\Claude\claude_desktop_config.json
     

2. Senso MCP サーバーの設定をファイルに追加します。

   {
       "mcpServers": {
           "senso": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/api-mcp-server",
                   "run",
                   "server.py"
               ]
           }
       }
   }
   

   Windows の場合は、適切なパス形式を使用します。

   {
       "mcpServers": {
           "senso": {
               "command": "uv",
               "args": [
                   "--directory",
                   "C:\\ABSOLUTE\\PATH\\TO\\api-mcp-server",
                   "run",
                   "server.py"
               ]
           }
       }
   }
   

   ⚠️ 重要：パスを、クローンしたリポジトリの絶対パスに置き換えてください。

3. Claude Desktop を再起動して、変更を適用します。

Claude で MCP ツールを使う

サーバーをセットアップし、Claude Desktop を設定したら、自然言語でのやり取りを通じてツールを使用できます。

コンテンツの追加

Claude に次のように依頼します。

Please add this information to my knowledge base:
Title: Introduction to MCP
Summary: A brief overview of the Model Context Protocol
Text: The Model Context Protocol (MCP) allows large language models to interact with external tools and data sources. It enables Claude to perform actions like retrieving information, accessing files, and executing operations through a standardized interface.

コンテンツの検索

Claude に次のように依頼します。

Can you search my knowledge base for information about "MCP"?

コンテンツの生成

Claude に次のように依頼します。

Using my knowledge base, please generate a tutorial about AI assistants and save it to my knowledge base.

トラブルシューティング

ログの確認

問題が発生した場合は、Claude Desktop のログを確認してください。

• macOS：~/Library/Logs/Claude/mcp-server-senso.log
• Windows：%APPDATA%\Claude\Logs\mcp-server-senso.log

よくある問題

• Claude にツールが表示されない：Claude Desktop が再起動されていることと、設定ファイルの形式が正しいことを確認してください。
• API キーの問題：API キーを更新する必要がある場合は、server.py ファイルで直接編集してください。
• パスの問題：Claude の設定では相対パスではなく、絶対パスを使用していることを確認してください。

uv の更新

uv で問題が発生した場合は、最新バージョンを使用していることを確認してください。

curl -LsSf https://astral.sh/uv/install.sh | sh

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス

---

Senso API との連携のために作成