MCP Sap Notes

🚀 SAP Note Search MCP Server

SAPパスポート認証とPlaywright自動化を使用して、SAPノートやKB記事を検索するMCPサーバーです。

このModel Context Protocol (MCP) サーバーは、Cursor AIを通じてSAPノートとKnowledge Base記事に直接アクセスできます。SAPパスポート証明書認証とPlaywrightブラウザー自動化を使用して、SAPシステムから実際のノート内容を取得します。

🚀 クイックスタート

前提条件

• Node.js 18+ - ここからダウンロード
• SAPパスポート証明書 - 個人用の .pfx 証明書ファイル
• Cursor AI - ここからダウンロード

インストール

1. リポジトリをクローン

   git clone https://github.com/marianfoo/mcp-sap-notes
   cd mcp-sap-notes
   

2. 依存関係をインストール

   npm install
   

3. プロジェクトをビルド

   npm run build
   

セットアップ

1. SAPパスポート証明書を取得 - Sユーザーのみ可能

   • SAPパスポートにアクセス
   • 証明書を作成
   • .pfx 証明書ファイルをダウンロード

2. 証明書ディレクトリを作成

   mkdir certs
   

3. SAPパスポート証明書をコピー

   • .pfx 証明書ファイルを certs/ ディレクトリに配置
   • sap.pfx と名前を付ける（または設定でパスを更新）

4. 環境を設定

   cp .env.example .env
   

   .env を編集し、証明書のパスフレーズを追加:

   PFX_PATH=./certs/sap.pfx
   PFX_PASSPHRASE=your_actual_passphrase
   

Cursorに接続

1. Cursorの設定を開く (Cmd/Ctrl + ,)

2. MCPサーバーの設定を追加 して settings.json に保存:

   {
     "mcpServers": {
       "sap-note-search": {
         "command": "node",
         "args": ["/full/path/to/sap-note-search-mcp/dist/mcp-server.js"]
       }
     }
   }
   

   ⚠️ 重要: /full/path/to/sap-note-search-mcp を実際のプロジェクトディレクトリの完全パスに置き換えてください。

3. Cursorを再起動 - SAPノートツールがAIアシスタントに表示されます。

✨ 主な機能

• 🔍 直接的なSAPノートアクセス - ノートの完全な内容とメタデータを取得
• 🎫 SAPパスポート認証 - セキュアな証明書ベースの認証
• 🤖 Playwright自動化 - 複雑なSAP認証フローを処理
• 💾 スマートキャッシュ - 認証トークンをローカルにキャッシュ
• 🔧 デバッグ容易 - 包括的なロギングとトラブルシューティングオプション
• 📋 MCP準拠 - Cursor AIとシームレスに動作

🔍 Cursorでのライブプレビュー

💻 使用例

基本的な使用法

Find SAP Note 2744792

高度な使用法

Search for SAP Notes about "OData gateway metadata error"

Get the full content of SAP Note 2744792

🛠️ テストと開発

認証テスト

npm run test:auth

これはSAPパスポート認証フローをテストし、証明書の設定を検証します。

APIアクセステスト

npm run test:api

これはSAPノートAPIの統合と内容抽出をテストします。

完全なMCPサーバーテスト

npm run test:mcp

これは完全なMCPサーバーワークフローをシミュレートします。

すべてのテストを実行

npm run test

🐛 トラブルシューティング

証明書の問題

エラー: "Certificate file not found"

• 設定内の証明書パスが正しいことを確認
• Cursorの settings.json で完全な絶対パスを使用
• 証明書ファイルが存在し、読み取り可能であることを確認

エラー: "Authentication failed"

• 証明書のパスフレーズが正しいことを確認
• SAPパスポート証明書が有効で、期限切れでないことを確認
• HEADFUL=true で実行して、ブラウザー認証を確認

ブラウザーの問題

エラー: "Browser launch failed"

# Playwrightブラウザーをインストール
npx playwright install

認証がハングまたはタイムアウトする

• デバッグモードで実行: HEADFUL=true npm run test:auth
• SAPシステムへのネットワーク接続を確認
• 証明書が適切なSAPシステムアクセス権を持っていることを確認

MCP統合の問題

Cursorにツールが表示されない

• Cursorを完全に再起動
• settings.json 内のMCPサーバーパスが絶対パスであることを確認
• cwd 設定がプロジェクトディレクトリを指していることを確認

エラー: "MCP server failed to start"

• Cursorの開発者ツールのコンソール出力を確認
• すべての依存関係がインストールされていることを確認: npm install
• ビルドが正常に完了したことを確認: npm run build

デバッグモード

詳細なトラブルシューティングのためにデバッグモードを有効にします。

# デバッグ用の環境変数を設定
export HEADFUL=true
export LOG_LEVEL=debug

# 可視ブラウザーでテストを実行
npm run test:auth

📁 プロジェクト構造

sap-note-search-mcp/
├── src/
│   ├── mcp-server.ts        # メインMCPサーバー
│   ├── auth.ts              # SAP認証
│   ├── sap-notes-api.ts     # SAPノートAPIクライアント
│   ├── types.ts             # TypeScript定義
│   └── logger.ts            # ロギング設定
├── test/
│   ├── test-auth.js         # 認証テスト
│   ├── test-sap-api.js      # APIテスト
│   └── test-mcp-server.js   # 完全なサーバーテスト
├── dist/                    # コンパイルされたJavaScript
├── certs/                   # 証明書ディレクトリ
├── .env.example             # 環境テンプレート
└── README.md               # このファイル

⚙️ 設定

環境変数

Playwright設定

サーバーは必要なPlaywright依存関係を自動的にインストールします。手動でインストールする場合は:

npx playwright install chromium

🔒 セキュリティ

• 証明書セキュリティ: あなたのSAPパスポート証明書は決してあなたのマシンを離れません。
• トークンキャッシュ: 認証トークンはローカルにキャッシュされ、自動的に期限切れになります。
• データ保存なし: SAPノートの内容は必要に応じて取得され、保存されません。
• セキュアな通信: すべてのSAP API呼び出しは証明書認証付きのHTTPSを使用します。

📋 利用可能なツール

sap_note_search

ノートIDまたはキーワードでSAPノートとKB記事を検索します。

パラメーター:

• q (文字列、必須): クエリ文字列またはノートID
• lang (文字列、任意): 言語コード ("EN" または "DE")、デフォルトは "EN"

sap_note_get

特定のSAPノートの完全な内容とメタデータを取得します。

パラメーター:

• id (文字列、必須): SAPノートID (6 - 8桁)
• lang (文字列、任意): 言語コード ("EN" または "DE")、デフォルトは "EN"

🤝 コントリビューション

1. リポジトリをフォーク
2. 機能ブランチを作成: git checkout -b feature/amazing-feature
3. 変更をコミット: git commit -m 'Add amazing feature'
4. ブランチにプッシュ: git push origin feature/amazing-feature
5. プルリクエストを作成

📄 ライセンス

このプロジェクトはApache 2.0ライセンスの下でライセンスされています。詳細については、LICENSEを参照してください。