Claude Connect

一个兼容 MCP 的外部连接器服务器，使 Claude 和其他 LLM 能够与 Web API、文件系统和自定义资源进行交互。 v1.1 (2025 年 3 月)

概述

Claude Connect 是一个实现了 Anthropic 的模型上下文协议 (MCP) 的服务器，允许像 Claude 这样的大型语言模型以标准化的方式与外部工具和资源进行交互。 该服务器使 LLM 能够访问 Web 搜索结果、在沙盒环境中读写文件以及利用自定义资源。

主要特性

• Web 搜索集成：连接到 Bing 搜索 API（必需）和 Google 搜索 API（可选）
• 文件操作：在安全沙箱中读取、写入、列出和删除文件
• 自定义资源：定义和访问自定义资源类型
• 提示模板：存储和检索自定义提示模板
• 多种传输选项：主要的 STDIO 传输用于 Claude Desktop 集成，可选的 HTTP 传输带有 JWT 身份验证
• 可扩展的架构：易于添加新功能和资源
• 跨平台：已在 Windows 10 上测试，但设计为可在任何支持 Python 3.10+ 的平台上运行

快速开始

此 MCP 服务器使像 Claude 这样的大型语言模型能够访问外部工具和资源。 设置大约需要 15 分钟，并且需要 Python 3.10+ 和用于搜索功能的 API 密钥。 请按照以下步骤开始：

1. 安装 Python 3.10+，创建一个虚拟环境并激活它（例如，在 Windows 上使用 python -m venv venv 和 ..\venv\Scripts\activate）。
2. 安装依赖项：..\venv\Scripts\pip.exe install -r requirements.txt（使用完整路径有助于绕过潜在的 PowerShell 执行策略问题）。
3. 将 .env.example 重命名为 .env 并添加您的 API 密钥（Bing 搜索 API 是必需的，Google 搜索 API 是可选的）。
4. 在 STDIO 模式下运行服务器：..\venv\Scripts\python.exe main.py 或 HTTP 模式：..\venv\Scripts\python.exe main.py --http。
5. 使用 ..\venv\Scripts\pytest.exe 进行测试。

注意：某些命令，尤其是激活或安装，可能需要在 Windows 上以管理员身份运行 PowerShell/CMD，具体取决于您的系统配置。

有关详细的设置说明，请参阅 设置指南。 有关 Claude Desktop 集成，请参阅 Claude Desktop 集成指南。

文档

• 设置指南
• 配置指南
• Claude Desktop 集成
• API 参考
• 高级用法
• 故障排除

高级用法

对于高级用法场景，包括：

• 手动 JSON-RPC 交互
• 使用 PostgreSQL 而不是 SQLite
• 使用 Redis 缓存
• 国际化
• 性能调优
• 使用新的功能扩展服务器

请参阅 高级用法指南。

代码解释 & 设计原理

Claude Connect 服务器的设计遵循以下原则：

• 模块化：每个功能都实现为一个单独的处理程序函数。
• 安全性：文件操作仅限于沙箱目录，并防止路径遍历尝试。
• 可扩展性：可以通过实现新的处理程序函数并更新功能列表来添加新功能。
• 可配置性：服务器的大多数方面都可以通过环境变量和配置文件进行配置。

服务器支持两种传输模式：

• STDIO：用于与 Claude Desktop 和其他支持 STDIO 传输的 MCP 客户端集成。
• HTTP：用于开发、测试以及与 Web 应用程序集成。

有关代码结构和设计决策的更多详细信息，请参阅 API 参考。

容器化 & 部署

您可以使用 Docker 容器化 Claude Connect：

# Dockerfile
FROM python:3.11-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .
RUN mkdir -p sandbox

EXPOSE 8000

CMD ["python", "main.py", "--http"]

构建并运行 Docker 容器：

docker build -t claude-connect .
docker run -p 8000:8000 --env-file=.env claude-connect

有关更多部署选项，包括 Windows 服务和 systemd，请参阅 高级用法指南。

未来增强

计划在未来版本中进行的增强包括：

• WebSocket 传输：用于与 Web 应用程序进行实时通信。
• 更多搜索提供商：与其他搜索 API 集成。
• 增强的身份验证：HTTP 模式的更多身份验证选项。
• 管理仪表板：用于管理服务器的 Web 界面。
• 插件系统：一个用于使用自定义功能扩展服务器的插件系统。

故障排除

如果您遇到问题，请查看 故障排除指南 以获取常见问题和解决方案。

要获得更详细的日志记录，请在 main.py 中将日志级别设置为 DEBUG：

logging.basicConfig(
    level=logging.DEBUG,  # 从 INFO 更改为 DEBUG
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)

贡献

欢迎贡献！ 请查看我们的 贡献指南 和 行为准则。

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

社区

• GitHub Issues：用于错误报告和功能请求
• Discord 服务器：用于讨论和社区支持（即将推出）