README.md•3.03 kB
# company-mcp-server
自社システム用のModel Context Protocol (MCP)サーバー（Python実装）
## 概要
このMCPサーバーは、AI（LLM）が自社システムにアクセスし、以下の機能を利用できるようにします：
- データの検索・取得
- 情報の更新
- レポートの生成
- システム連携
## 必要要件
- Python 3.10以上
- pip
- 自社システムのAPIアクセス権限
## インストール
```bash
pip install -e .
```
## 設定方法
### Claude Desktopでの使用
`claude_desktop_config.json`に以下を追加：
```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): 対象期間
## 開発
### ローカル開発環境のセットアップ
```bash
git clone https://github.com/keythpiece/company-mcp-server.git
cd company-mcp-server
pip install -e ".[dev]"
```
### テスト
```bash
pytest
```
### MCP Inspectorでのテスト
```bash
mcp dev src/company_mcp_server/server.py
```
ブラウザで`http://localhost:5173`を開いてテストできます。
## アーキテクチャ
このMCPサーバーは以下のSDKを使用しています：
- [mcp](https://pypi.org/project/mcp/) - Model Context Protocol Python SDK
## セキュリティ
- APIキーは環境変数で管理してください
- 本番環境では適切な認証・認可を実装してください
- ログに機密情報を出力しないよう注意してください
## トラブルシューティング
### よくある問題
**接続エラーが発生する**
- 環境変数が正しく設定されているか確認してください
- APIエンドポイントにアクセスできるか確認してください
**認証エラーが発生する**
- APIキーが有効か確認してください
- APIキーの権限が適切か確認してください
**import errorが発生する**
- `pip install -e .`でパッケージをインストールしてください
- Python 3.10以上を使用しているか確認してください
## ライセンス
MIT License
## 貢献
プルリクエストを歓迎します。大きな変更の場合は、まずissueを開いて変更内容を議論してください。
## サポート
問題や質問がある場合は、[Issueを作成](https://github.com/keythpiece/company-mcp-server/issues)してください。