Far MCP Server

🚀 FAR Oracle - 面向AI智能體的MCP服務器

FAR Oracle是一個模型上下文協議（MCP）服務器，它能讓AI智能體即時、以編程方式訪問美國聯邦採購法規（FAR）。

該服務器允許像Claude Desktop、AutoGPT和CrewAI這樣的智能體對整個FAR數據庫執行語義搜索，從而幫助處理政府合同的合規性審查、研究以及提案撰寫等工作。

✨ 主要特性

• 語義搜索：理解查詢背後的“意圖”，而非僅僅匹配關鍵詞。
• 智能體對智能體（A2A）商務模式：首次使用時可零摩擦自動註冊API密鑰。
• 即時更新：持續更新以包含最新的FAR條款。
• 輕鬆集成：可與任何兼容MCP的智能體無縫協作。

🚀 快速開始

僅需兩步，即可讓您的智能體與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商務模式

此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文件。