mcpField
A
actually

actually

ローカル
github.com金融データ03 日前に更新

actually について

Actuallyは、ニュース記事をPolymarketのリアルタイム市場に照合し、市場が示す確率を表示するChrome拡張機能とMCPサーバーです。記事の照合はローカルで行い、英語以外のページもローカル翻訳できます。任意のウォレット連携ツールでは、上限付き取引も可能です。

主な機能

  1. 01記事本文をリアルタイム市場に照合
  2. 02市場が示す確率を表示
  3. 03ローカル埋め込みモデルによる記事照合
  4. 04英語以外のページをローカル翻訳
  5. 05任意のウォレット連携取引ツール

活用シーン

  1. 01ニュース記事に関連する予測市場のオッズを確認する
  2. 02見出しから関連市場を探す
  3. 03ポジションと損益を確認する
  4. 04設定時に上限付き取引や注文取消を行う

MCP 対応

MCPサーバーはニュース確認と市場取得のツールを提供します。秘密鍵を設定すると、注文、売却、注文取消、ポジション確認も利用できます。取引上限はサーバー側で適用されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"sofiia7-actually": {
"command": "npx",
"args": [
"-y",
"actually-mcp-server"
],
"env": {
"POLYMARKET_PRIVATE_KEY": "<POLYMARKET_PRIVATE_KEY>",
"ACTUALLY_MAX_ORDER_USD": "<ACTUALLY_MAX_ORDER_USD>",
"ACTUALLY_DAILY_LIMIT_USD": "<ACTUALLY_DAILY_LIMIT_USD>",
"ACTUALLY_ENABLE_REDEEM": "<ACTUALLY_ENABLE_REDEEM>",
"ACTUALLY_SEARCH_FALLBACK": "<ACTUALLY_SEARCH_FALLBACK>",
"ACTUALLY_SPEND_STATE_PATH": "<ACTUALLY_SPEND_STATE_PATH>",
"ACTUALLY_WORKER_URL": "<ACTUALLY_WORKER_URL>",
"ACTUALLY_WORKER_SECRET": "<ACTUALLY_WORKER_SECRET>"
}
}
}
}
起動コマンドnpx -y actually-mcp-server
設定が必要な環境変数
POLYMARKET_PRIVATE_KEYシークレットOptional. Your own Polygon EOA private key. Enables the trading tools (place_order, sell_order, cancel_order, get_open_orders, get_positions). Omit to run signal-only, which needs no key and no wallet.
ACTUALLY_MAX_ORDER_USDOptional. Per-order USD cap for the trading tools (default 100). Enforced server-side against the market's own price, so a caller cannot understate an order to slip past it.
ACTUALLY_DAILY_LIMIT_USDOptional. Rolling UTC-day USD cap shared by place_order and sell_order (default 500). Held in a persisted ledger, so it survives restarts.
ACTUALLY_ENABLE_REDEEMOptional. Set to exactly 'true' to additionally register redeem_position. A second opt-in beyond the private key, because it submits a real on-chain transaction through Polymarket's relayer and is still in testing.
ACTUALLY_SEARCH_FALLBACKOptional. Set to exactly 'true' to let check_news fall back to Polymarket's own market search when nothing in the cached set matches. Off by default: the query is built from the caller's text and leaves the machine.
ACTUALLY_SPEND_STATE_PATHOptional. Where the spend ledger is stored (default ~/.actually-mcp-server/spend-guard.json).
ACTUALLY_WORKER_URLOptional. Only if you run your own Cloudflare Worker instead of the shared default.
ACTUALLY_WORKER_SECRETシークレットOptional. Shared secret for your own Worker. Not a private credential: the default one ships inside every client by design.

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmactually-mcp-server0.1.10

ツール

2

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
textstringはい

詳細

実際のところ、市場はどう考えているのか

すでに読んでいるニュース記事の上に、予測市場のオッズを表示する Chrome 拡張機能と MCP サーバーです。

ニュースでは、「専門家が懸念している」や「オッズが上昇している」と伝えられますが、具体的な数値が示されることはほとんどありません。その数値は予測市場にあります。そこでは、人々が結果に自分のお金を賭けています。ただ、別のタブにあるため、見つけるには、そもそもそのような市場があると知っている必要があります。

Actually は、その隔たりを埋めます。記事を開いてツールバーのアイコンをクリックすると、拡張機能が本文を現在の Polymarket 市場と照合し、市場独自の確率を表示します。アカウントもウォレットも登録も必要ありません。

Chrome ウェブストアから Chrome に追加 — 無料です。

ニュース記事と、現在の Polymarket 市場との照合結果

できること

  • 記事を市場と照合します。 ローカル埋め込みモデル(Xenova/all-MiniLM-L12-v2、約 33 MB)で記事本文とキャッシュ済みの市場をスコアリングし、キーワードと数値の重なりを加味します。数値が重要なのは、エンコーダーが数値をほとんど認識できないためです。「57,500 ドルまで下落する」と「120,000 ドルに到達する」は、埋め込み表現がほぼ同じになります。

  • デバイス上で動作します。 モデルと WASM ランタイムはビルド時にバンドルされるため、インストール時にも実行時にも CDN から取得することはありません。デフォルト設定では、記事本文がデバイスの外に送信されることもありません。

  • 英語以外のページも読み取れます。 Chrome に組み込まれた Translator API(ローカル処理、ネットワーク通信なし)を使って、照合前に英語へ翻訳します。Polymarket の質問はすべて英語で書かれており、ローカルモデルが保持するキリル文字のトークンは 30522 個中 86 個だけです。そのため、翻訳されていないロシア語の見出しを埋め込むとノイズになります。翻訳すると、同じ見出しは実際に関連する市場に対して 0.53〜0.71 のスコアになり、下限の 0.35 を上回ります。

    ベルリンの選挙市場と照合されたドイツ語の記事

  • 必要に応じて取引できます。 任意の WalletConnect v2 ウォレットを接続して、指値注文と成行注文、売却、未約定注文のキャンセルを行えます。また、取得原価と損益を確認できるポジションパネルもあります。秘密鍵や資金を当社が保管することはありません。

  • エージェントにも機能を提供します。 同じ機能を Model Context Protocol 経由で利用できます:check_news、get_market、place_order、sell_order、cancel_order、get_positions。

MCP サーバーの使用

MCP サーバーは公開されているため、クローンやビルドは不要です。任意の MCP クライアント(Claude Desktop、Cursor など、プロトコルに対応するもの)に追加してください。

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": ["actually-mcp-server"]
    }
  }
}

これにより、エージェントはシグナルツールである check_news と get_market を利用できるようになります。キーもウォレットも必要ありません。見出しとともに「市場はこれについてどう考えている?」と尋ねると、市場独自の価格を使って回答します。

初回起動時にパッケージとローカルモデルのランタイム(約 170 MB)がダウンロードされ、最初の check_news の実行時に 34 MB のモデルが取得されます。接続が遅い場合、クライアントがサーバーの起動を待つ時間を超えることがあります。タイムアウトが報告された場合は、ターミナルで npx -y actually-mcp-server を一度実行し、完了してからクライアントを再起動してください。以降の起動は数秒で完了します。

取引ツールは、ご自身のキーを指定した場合にのみ利用できます。

"env": {
  "POLYMARKET_PRIVATE_KEY": "0x...",
  "ACTUALLY_MAX_ORDER_USD": "100",
  "ACTUALLY_DAILY_LIMIT_USD": "500"
}

どちらの上限も、永続化された支出台帳に基づいてサーバー側で適用されます。そのため、エージェントが異なる価格を主張して上限を回避することはできません。 redeem_position は実際のオンチェーントランザクションを送信し、現在もテスト中のため、明示的なオプトイン(ACTUALLY_ENABLE_REDEEM=true)がさらに必要です。

すべての環境変数とガードの理由を含むドキュメント全文:packages/mcp-server/README.md。

公式 MCP レジストリに io.github.Sofiia7/actually として登録されているほか、mcpservers.org と Glama にも掲載されています。

mcpservers.org に掲載

actually MCP サーバー

連携の仕組み

extension/            Chrome MV3 extension (React popup, offscreen document)
extension/worker/     Cloudflare Worker - API proxy, rate limiting, market cache
packages/core/        Matching, pricing and Polymarket API logic, shared by both clients
packages/mcp-server/  MCP server, published to npm as actually-mcp-server
packages/market-cache-builder/   Cron job that precomputes the market embeddings

負荷の高い処理はオフスクリーンドキュメントで実行されます。MV3 サービスワーカーでは WASM を実行したり、WebSocket を保持したり、注文への署名に必要な時間まで処理を継続したりできないためです。

マーケットキャッシュには、事前計算済みの埋め込み表現を持つ 2,000 件のオープン市場が保存されており、2 時間ごとに再構築されます。選定では、24 時間の取引量、累計取引量、直近性という 3 つの順序付けを組み合わせます。累計取引量だけで順位付けすると、ニュースツールに適した候補を見つけられないためです。今朝、今日の見出しに合わせて開設された市場には履歴がなく、毎回、1 年前の選挙市場より下位になってしまいます。

Workerを使うことで、クライアント側で認証情報を保持する必要がなくなります。Polymarket の API を中継し、事前計算済みのキャッシュを提供するとともに、リレイヤー用のリモート署名者として機能します。そのため、ビルダー認証情報はサーバー上にとどまり、拡張機能に含まれることはありません。

実行方法

npm install
npm run models:fetch -w extension   # bundle the embedding model
npm run build -w extension          # type-check + build to extension/dist

extension/dist を、Chrome でパッケージ化されていない拡張機能として読み込みます。事前に extension/.env.example を .env.local にコピーして、必要事項を記入してください。ビルド時に Worker の URL、WalletConnect のプロジェクト ID、ビルダーコードが埋め込まれます。

npm test --workspaces               # 822 tests across four workspaces

プライバシー

探索は無料で、アカウントも不要です。コンテンツスクリプトはありません。ページが読み取られるのはクリックしたときだけで、対象はアクティブなタブのみです。デフォルト設定(ローカル埋め込み表現)では、記事のテキストが端末の外部に送信されることはありません。ページで翻訳が必要な場合も、埋め込みプロバイダーにかかわらず、ブラウザー内蔵の翻訳機能を使ってローカルで実行されます。テレメトリーはオプトイン方式で、デフォルトでは無効です。

プライバシーポリシー全文:https://actually-api.sofiaseremeteva.workers.dev/privacy

ステータス

拡張機能は Chrome ウェブストア で公開されています。 actually-mcp-server は npm で公開され、公式 MCP レジストリに掲載されています。

解決済みのポジションの払い戻し機能はテスト中です。ビルダー認証、ネガティブリスク契約の選択、残高ゼロ時のガードはそれぞれ実サービスで検証済みですが、払い戻しによって資金が最後まで回収された事例はまだ確認されていません。

オッズの確認はどこでも可能です。新しいポジションの開始は Polymarket 独自の制限 に従います。米国、英国、フランス、ドイツ、イタリア、オランダ、ベルギー、ポーランド、アイルランド、オーストラリア、ニュージーランド、日本、シンガポール、台湾、タイ、ブラジル、ロシア、およびカナダのオンタリオ州、ブリティッシュコロンビア州、アルバータ州、ケベック州などでは利用できません。ただし、既存のポジションの売却や、未約定注文のキャンセルは引き続き可能です。制裁対象地域では、全面的にブロックされます。この確認は Worker 上で実行されます。

Actually は金融アドバイスを提供しません。

Polymarket ツールのディレクトリ

  • PolyMart:Polymarket ツールのディレクトリです。

ライセンス

LICENSE を参照してください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。