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