mcp-server

Vibe-Research

Name: Vibe-Research
Author: simonlin1212

Vibe-Research: Your Personal Trading Research Agent · A股/美股/港股的个人投研 Agent：每日复盘、资讯雷达、个股数据、板块中心、我的持仓、研究记录、回测。Vibe-Research 把数据和功能配齐，由你自己的 Agent 驱动投资研究。基于开源的 Codex Harness 打造。

2,782 stars+64★ this week573 forksTypeScriptUpdated 10/23/2026100% free · open source

What it does

Vibe-Research is a self‑hosted TypeScript server that lets you ask a personal AI agent for daily stock market recaps, news radar, individual ticker data, sector overviews, portfolio tracking and back‑testing for A‑shares, US‑shares and Hong‑Kong shares.

When to use it

•You need an automated daily market‑summary for the stocks you follow without relying on a third‑party SaaS.
•You want to run custom back‑tests or query sector‑level data on‑demand via a chat‑style interface.
•You prefer to keep all market data and research history inside your own infrastructure for security or compliance.

Ready-to-paste prompt

Fetch a 7‑day back‑test for the ticker AAPL using a simple moving‑average crossover strategy and output the win‑rate and Sharpe ratio.

Heads up: The server won’t start until you provide valid API keys for the data providers (e.g., Alpha Vantage, Tencent, or Tinkoff); missing keys cause the process to exit with ‘Missing required environment variable …’ errors.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/vibe-research && curl -fsSL https://workflowstacks.com/api/skills/vibe-research/claude-skill -o ~/.claude/skills/vibe-research/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How Vibe-Research works

Codeflow

Free to inspect

Vibe-Research is a very large TypeScript project (~127k lines across 365 code files, plus 233 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, MIT license, has a test suite.

Size

Very large codebase

~127k lines · 365 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

TypeScript

No API keys detected

TypeScript 70%Python 29%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
calc/cli.py
Where the program starts running

What's in each folder

providers/Sub-packages / plugins8 files

docs/Documentation38 files

orchestrator/Folder221 files

desktop/Folder209 files

backtest/Folder56 files

calc/Folder23 files

scripts/Helper scripts19 files

datasources/Folder10 files

READMEHas testsDocumentedCI checksMIT licenseUpdated this month