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
• 認証が必要な呼び出しを行うユーザーは、認証セクションに 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: [] は認証不要を意味します）。この情報は次の 2 つの方法で公開されます。

• tools/list では、各ツールに _meta: { "requiresAuth": true | false } が含まれます。
• .well-known/mcp.json には同じ _meta フラグが含まれ、security ブロックは認証が必要なツールにのみ付与されます。

クライアントはこの情報を使って、トークンをユーザーに求めずに公開エンドポイントを呼び出し、認証情報が必要なツールに限って認証情報を要求できます。