AI导哈

模型上下文协议服务器

Contraption Company MCP是一个基于Chroma Cloud构建的模型上下文协议服务器，提供自动索引、全文搜索和快速查询功能，适用于博客内容管理和开发者工具集成。

  • by philipithomas
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 contraptionco/mcp

使用说明

合同公司MCP

MCP（模型上下文协议）服务器 承包公司 文章，建立在 铬云.

如何安装

Contraction Company MCP可作为无需身份验证的托管MCP服务器使用。

字段 值
服务器URL https://mcp.contraption.co

如何在普通客户端中配置

Cursor

使用深度链接直接在Cursor中安装： 安装合同公司MCP.

或者，创建或编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "contraption-company": {
      "url": "https://mcp.contraption.co"
    }
  }
}
ChatGPT
  1. 打开 设置→ 连接器.
  2. 点击 创建新连接器.
  3. 集 MCP服务器URL 到 https://mcp.contraption.co.
  4. 将身份验证留空并保存。
VS Code (Copilot Chat MCP)

创建或编辑 .vscode/mcp.json:

{
  "servers": {
    "contraption-company": {
      "type": "http",
      "url": "https://mcp.contraption.co"
    }
  }
}
Codex

增添 ~/.codex/config.toml:

[mcp_servers.contraption-company]
command = "npx"
args = ["mcp-remote", "--transport", "http", "https://mcp.contraption.co"]
Claude Code

在终端中运行：

claude mcp add --transport http contraption-company https://mcp.contraption.co
OpenAI SDK (Python) 
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5",
    input="List the newest Contraption Company blog posts.",
    tools=[
        {
            "type": "mcp",
            "server_label": "contraption-company",
            "server_url": "https://mcp.contraption.co",
            "require_approval": "never",
        }
    ],
)
print(response)

特性

  • 搜索：按查询文本查找帖子和页面
  • 自动索引：启动时通过预定轮询与博客API同步
  • 完整内容访问：对所有已发布的帖子和页面进行索引，包括仅限成员的内容
  • 快速性能：由FastAPI和Chroma Cloud提供支持
  • 背景更新：每隔几分钟对Ghost进行一次新的、更新的或删除的帖子和页面的轮询
  • 查询日志：在专用Chroma集合中搜索记录以进行分析
  • Docker Ready：包括Dockerfile，便于部署
  • 测试良好：带pytest的综合测试套件

在本地运行

  1. 克隆并安装：
git clone <repository>
cd mcp
uv sync --all-extras
  1. 配置环境：
cp .env.example .env
# Edit .env with your credentials
  1. 运行服务器：
./run.sh
# Or: uv run python -m src.main

码头工人

# Build
docker build -t contraption-mcp .

# Run
docker run -p 8000:8000 --env-file .env contraption-mcp

# Or use docker-compose
docker-compose up

配置

在本地运行需要外部服务的凭据：

  • Ghost管理员API密钥：从Ghost管理面板（设置>集成）
  • Chroma Cloud证书：来自Chroma Cloud的租户ID、数据库和API密钥
  • Chroma查询集合（可选）：设置 CHROMA_QUERY_COLLECTION 覆盖默认值 queries 收集
  • 航行API密钥：需要生成上下文化嵌入
  • 幽灵博客URL：你的Ghost博客的URL
  • 轮询间隔（可选）：设置 POLL_INTERVAL_SECONDS 覆盖默认的5分钟同步节奏
  • 默认情况下，仅限成员的内容和查询日志记录处于启用状态。确保您的隐私政策和访问控制涵盖这两者。

支持和隐私

  • 支持: hello@contraption.co
  • 隐私政策: https://www.contraption.co/privacy/
  • 启用了查询日志记录和仅限成员的内容，隐私政策必须涵盖这两者。

MCP工具

  • fetch(id)：使用规范URL作为标识符获取单个帖子或页面。提供 id 返回由 list_posts/search （这是规范URL）；slug和简写方案也被接受，但响应总是解析为完整的URL。
  • list_posts(sort_by, page, limit)：列出带有分页的帖子，返回规范URL作为标识符
  • search(query, limit)：按查询文本搜索帖子和页面；返回结果ID的规范URL

API终点

  • GET /：服务器信息（非MCP请求重定向到GitHub仓库）
  • GET /health：健康检查
  • GET /debug/search：调试搜索端点（请参见 /debug/docs 用于Swagger UI）
  • /mcp/*：MCP协议端点

背景同步

服务器每5分钟轮询Ghost Admin API一次，以检测新的、更新的或删除的帖子和页面。通过设置来调整节奏 POLL_INTERVAL_SECONDS 环境变量。

发展

# Install dev dependencies
make dev

# Run tests
make test

# Lint and format
make format lint

# Run all checks
make check

许可证

麻省理工学院

相关 MCP