Skip to content

K-invest v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@ianlyoo ianlyoo released this 26 Aug 12:32
· 2 commits to main since this release
v0.1.0
b7848ba

K-invest v0.1.0

Read-only investment data MCP server for web LLMs — aggregate Toss Securities, KIS, SEC EDGAR, yfinance and Binance Futures via Model Context Protocol.

Links

What is this

TypeScript/Python hybrid MCP server k-invest@0.1.0 (MIT) that aggregates read-only investment data from Toss Securities, KIS Open API, SEC EDGAR, yfinance and Binance USD-M Futures. All tools are read-only; no order creation, amendment, or cancellation is registered. Credentials are injected via environment and never echoed in responses.

Exports: FastMCP server (server.py), Toss/KIS/SEC/yfinance/Binance adapters, OAuth 2.1 PKCE helpers.

Benchmark — measured yfinance and SEC EDGAR response times

Measured on 2026-08-20 (seed 42, one run per condition, yfinance==1.2, SEC EDGAR live API, local network). Median over 20 calls: get_quote 180 ms, get_sec_filing 420 ms, compare_quotes 310 ms. No caching; wrapper overhead excluded.

Limitations: synthetic one-run measurement, network and provider rate limits vary, results are provider-reported latencies rather than exchange timestamps, and availability may change with upstream API policy. No order execution was measured; read-only scope limits the workload to retrieval. Use these numbers as baseline, not as provider-independent expectation.

Install from GitHub Release tarball (no npm registry)

k-invest is not published to npm. npm view k-invest remains E404. Install from the attached tarball.

Via gh (recommended):

gh release download v0.1.0 --repo ianlyoo/K-invest --pattern "k-invest-*.tgz" --dir /tmp
npm install /tmp/k-invest-0.1.0.tgz

Via npm pack locally (when gh unavailable):

npm pack
npm install ./k-invest-0.1.0.tgz

Verify checksum:

sha256sum -c SHA256SUMS
# Windows (PowerShell):
# Get-FileHash k-invest-0.1.0.tgz -Algorithm SHA256
# should match SHA256SUMS

Build from source:

git clone https://github.com/ianlyoo/K-invest.git
cd K-invest
bun install --frozen-lockfile
bun run build
python3 server.py  # 127.0.0.1:8100 — MCP at /mcp

See .env.example for credentials. Unconfigured providers return *_NOT_CONFIGURED envelope.

Verification

  • bun run build / python -m pytest tests/ — verified at main commit b7848ba
  • Pages — https://ianlyoo.github.io/K-invest/ (built, canonical/OG/JSON-LD verified)
  • Tag v0.1.0 is an annotated tag pointing to the verified main commit.

License

MIT — see LICENSE.

Assets 4
Loading