mcp-server

Vibe Research

Name: Vibe Research
Author: simonlin1212

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

2,540 stars+12★ this week (early data)518 forksTypeScriptUpdated 9/20/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/f678f621-6dca-4516-be1b-6c2ba303f82a && curl -fsSL https://workflowstacks.com/api/skills/f678f621-6dca-4516-be1b-6c2ba303f82a/claude-skill -o ~/.claude/skills/f678f621-6dca-4516-be1b-6c2ba303f82a/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 (~83k lines across 265 code files, plus 138 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

~83k lines · 265 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 72%Python 27%HTML 1%

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/Documentation37 files

orchestrator/Folder173 files

desktop/Folder109 files

backtest/Folder33 files

calc/Folder20 files

scripts/Helper scripts12 files

datasources/Folder9 files

READMEHas testsDocumentedCI checksMIT licenseUpdated this month