Syracuse Company News API

Syracuse Company 新 MCP 服务

安装说明

API 密钥

从 syracuse.1145.am 获取免费 API 密钥——只需提供电子邮箱地址。以下是用于获取密钥的 curl 命令：

curl -X POST "https://syracuse.1145.am/api/v1/register-and-get-key/" \
  -H "Content-Type: application/json" \
  -d "{\"email\":\"[email protected]\"}"

在确认密钥之前，你的使用额度会受到限制，因此请务必使用你能够访问的电子邮箱地址。

使用 MCP 服务

有 3 种方式：

1. 作为本地 MCP 服务运行（例如，连接 Claude Desktop）
2. 通过 Syracuse MCP 服务连接
3. 在本地运行自己的远程 MCP 服务

作为本地 MCP 服务运行

前提条件：安装 uv

1. 克隆此仓库
2. 将 .env.sample 复制为 .env，并使用上文获取的 API 密钥配置 MCP_SERVER_API_TOKEN
3. claude_desktop_config.json 示例

{
  "mcpServers": {
    "Syracuse Company News API": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/repo/syracuse-mcp-server",
        "run",
        "stdio_mcp_server.py"
      ]
    }
  }
}

通过 Syracuse 的 MCP 服务连接

没有特殊的前提条件

连接到 https://syracuse.1145.am/mcp，并在授权信息中提供你的密钥

MCP 文档位于 https://syracuse.1145.am/.well-known/mcp.json

运行自己的远程 MCP 服务

如果出于某种原因，你想运行自己的本地 MCP 服务，也可以实现。同样，它需要 uv。

你不需要在 .env 文件中更新密钥，但需要执行以下操作：

1. 克隆此仓库
2. 将 .env.sample 复制为 .env——无需进行其他配置
3. 使用 uv run stateless_streaming_http_mcp_server.py 运行

MCP Inspector 的连接信息：

• 传输类型：Streamable HTTP
• URL：host:port/mcp，例如 http://127.0.0.1:9000/mcp
• 任何需要授权的调用都必须在 Authentication 部分添加 API 密钥

无状态流式 MCP 服务还会在 .well-known/mcp.json 提供一个 mcp.json（在本例中，地址为 http://127.0.0.1/.well-known/mcp.json ）

允许的工具

默认情况下，ALLOWED_TOOLS 会将 MCP 服务限制为注册账户和获取故事所需的最少工具：

• register_and_get_key
• location_groups_list
• stories_industry_location_list
• stories_organization_list

允许使用所有工具也没有问题——如果你想试用，只需从 .env 中移除 ALLOWED_TOOLS

区分需要身份验证的工具

每个工具都会标注是否需要身份验证，该标注根据 OpenAPI security 规则确定（操作级别的 security 会覆盖规范级别的 security，显式的空 security: [] 表示无需身份验证）。此信息通过两种方式公开：

• 在 tools/list 中，每个工具都包含 _meta: { "requiresAuth": true | false }。
• 在 .well-known/mcp.json 中，也会包含相同的 _meta 标记；只有确实需要身份验证的工具才会附带 security 块。

客户端可以利用此信息调用公共端点，而无需提示用户提供令牌；仅在需要身份验证的工具需要凭据时才请求用户提供。