Far MCP Server

🚀 FAR Oracle - AIエージェント向けMCPサーバー

FAR Oracleは、米国連邦調達規則（FAR）に対して、AIエージェントが即時かつプログラム的にアクセスできるようにする、モデルコンテキストプロトコル（MCP）サーバーです。

このサーバーを使用することで、Claude Desktop、AutoGPT、CrewAIなどのエージェントがFARデータベース全体で意味検索を実行でき、政府契約のコンプライアンス、調査、提案書作成などの作業を支援することができます。

🚀 クイックスタート

2つの簡単な手順で、あなたのエージェントをFAR Oracleに接続しましょう。

ステップ1: PyPIからインストール

pip install far-oracle

ステップ2: エージェントを設定する（例: Claude Desktop）

エージェントのMCP設定ファイル（例: claude_desktop_config.json）に以下を追加します。

APIキーは、A2Aコマースによって自動的に処理されます。あなたが提供する必要はありません。

{
  "mcpServers": {
    "far-oracle": {
      "command": "far-oracle",
      "args": []
    }
  }
}

これで完了です！あなたのエージェントはFARにアクセスできるようになりました。

✨ 主な機能

• 意味検索：キーワードだけでなく、クエリの意図を理解します。
• A2Aコマース：初回使用時に自動的にAPIキーが登録され、摩擦なく利用できます。
• 常に最新：最新のFAR条項で継続的に更新されます。
• 簡単な統合：MCP互換のエージェントとシームレスに動作します。

🔧 技術詳細：A2Aコマースの仕組み

このMCPサーバーは、認証にエージェント間（A2A）コマースを使用しています。エージェントが初めて接続すると、自動的に以下のことが行われます。

1. 無料のAPIキーを登録します。
2. キーを~/.far-oracle/credentialsにローカルに保存します。
3. それ以降のすべてのリクエストにこのキーを使用します。

これにより、エージェントにとって完全にシームレスで摩擦のないオンボーディング体験が提供されます。

💻 使用例

設定が完了したら、エージェントに以下のような質問をすることができます。

"far-oracleツールを使用して、サイバーセキュリティに関するFARの要件は何ですか？"

"far-oracleを使って、FARパート19にある中小企業割当て規則を説明してください。"

"far-oracleを使用して、知的財産とデータ権に関連する契約条項を探してください。"

📚 ドキュメント：価格設定とプラン

FAR Oracleは、エージェントにやさしいシンプルな価格モデルを採用しています。すべての利用はA2AコマースAPIを通じて管理されます。

エージェントは、請求エンドポイントを呼び出すことで、プログラム的にプランをアップグレードすることができます。

📚 ドキュメント：トラブルシューティング

問題: command not found: far-oracle

• 原因：パッケージのスクリプトディレクトリがシステムのPATHに含まれていない可能性があります。
• 解決策：python3 -m site --user-base/binの出力がPATHに含まれていることを確認してください。または、実行可能ファイルの完全パスを使用することもできます。

問題: 接続エラーまたはタイムアウト

• 原因：ファイアウォールがFAR RAG APIへの接続をブロックしている可能性があります。
• 解決策：システムがhttps://far-rag-api-production.up.railway.appへのアウトバウンドリクエストを行えることを確認してください。

📚 ドキュメント：完全なAPIドキュメント

利用可能なすべてのエンドポイントとパラメータを含む、基盤となるREST APIの詳細については、以下の完全なAPIドキュメントを参照してください。

FAR RAG APIドキュメント

📄 ライセンス

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