keythpiece/company-mcp-server

company-mcp-server

自社システム用のModel Context Protocol (MCP)サーバー（Python実装）

概要

このMCPサーバーは、AI（LLM）が自社システムにアクセスし、以下の機能を利用できるようにします：

• データの検索・取得
• 情報の更新
• レポートの生成
• システム連携

必要要件

• Python 3.10以上
• pip
• 自社システムのAPIアクセス権限

インストール

pip install -e .

設定方法

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加：

{
  "mcpServers": {
    "company-server": {
      "command": "python",
      "args": ["-m", "company_mcp_server"],
      "env": {
        "API_KEY": "your_api_key",
        "API_ENDPOINT": "https://your-company-api.example.com"
      }
    }
  }
}

環境変数

• API_KEY: 自社APIのアクセスキー
• API_ENDPOINT: 自社APIのエンドポイントURL

利用可能なツール

search_data

説明: データベースから情報を検索します

パラメータ:

• query (str): 検索クエリ
• limit (int, optional): 取得件数（デフォルト: 10）

get_report

説明: レポートを生成します

パラメータ:

• report_type (str): レポートの種類
• date_range (str): 対象期間

開発

ローカル開発環境のセットアップ

git clone https://github.com/keythpiece/company-mcp-server.git
cd company-mcp-server
pip install -e ".[dev]"

テスト

pytest

MCP Inspectorでのテスト

mcp dev src/company_mcp_server/server.py

ブラウザでhttp://localhost:5173を開いてテストできます。

アーキテクチャ

このMCPサーバーは以下のSDKを使用しています：

• mcp - Model Context Protocol Python SDK

セキュリティ

• APIキーは環境変数で管理してください
• 本番環境では適切な認証・認可を実装してください
• ログに機密情報を出力しないよう注意してください

トラブルシューティング

よくある問題

接続エラーが発生する

• 環境変数が正しく設定されているか確認してください
• APIエンドポイントにアクセスできるか確認してください

認証エラーが発生する

• APIキーが有効か確認してください
• APIキーの権限が適切か確認してください

import errorが発生する

• pip install -e .でパッケージをインストールしてください
• Python 3.10以上を使用しているか確認してください

ライセンス

MIT License

貢献

プルリクエストを歓迎します。大きな変更の場合は、まずissueを開いて変更内容を議論してください。

サポート

問題や質問がある場合は、Issueを作成してください。