Toshi (Codekshitij)

东市

询问有关任何上市公司的问题。获得基于真实美国证券交易委员会文件的答案。

"What risks did Apple disclose about China in their last 3 annual reports?"
"Are there any red flags in Tesla's financials?"
"What is Microsoft's financial risk score?"

______________________________________________________________________

什么是东？

Tōshi是一个MCP服务器，它使Claude可以访问SEC EDGAR——美国政府的公共数据库，其中包含每家上市公司的所有财务文件。

大多数人工智能工具都会从训练数据中回答财务问题。Tōshi从SEC EDGAR实时获取的实际源文件（年度报告、风险披露、财务报表）中给出了答案。

它可以做三件事：

1.财务数据 --直接从美国证券交易委员会的文件中提取真实数字

• 收入、净收入、现金流、债务、每股收益等
• 长达10年的历史
• 公司间的并排比较

2.金融情报 --分析这些数字的含义

• 异常检测——标记异常的同比变化
• 风险评分——5个财务维度的专有0-10分

3.提交问答 --搜索并阅读实际提交文本

• 用简单的英语提问
• 答案来自10-K文件的风险因素、MD&A和业务部分
• 每个答案都引用了公司、年份和章节

______________________________________________________________________

需求

• 克劳德桌面
• Python 3.11
• macOS、Linux或Windows

______________________________________________________________________

设置

1.克隆仓库

git clone https://github.com/yourusername/toshi.git
cd toshi

2.创建虚拟环境

python3.11 -m venv venv
source venv/bin/activate        # macOS / Linux
venv\Scripts\activate           # Windows

3.安装依赖项

pip install -r requirements.txt

4.配置您的电子邮件

SEC EDGAR要求在User-Agent标头中包含联系人电子邮件。创建一个 .env 文件：

cp .env.example .env

编辑 .env 并设置：

SEC_USER_AGENT="Toshi your-email@example.com"

5.连接到克劳德桌面

编辑您的Claude Desktop配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "toshi": {
      "command": "/absolute/path/to/toshi/venv/bin/python3",
      "args": ["/absolute/path/to/toshi/server.py"]
    }
  }
}

替换 /absolute/path/to/toshi 使用机器上的实际路径。

6.重新启动克劳德桌面

寻找🔨 锤子图标——确认东氏已连接。

______________________________________________________________________

用法

自然地问克劳德。不需要特殊命令。

示例：

"What was Apple's revenue over the last 5 years?"

"Compare Tesla and Ford's net income since 2021"

"Are there any red flags in Amazon's financials?"

"What is Microsoft's financial risk score?"

"What does Apple say about China risks in their 10-K filings?"

"How has Tesla's competition disclosure changed over the last 3 years?"

"What risks did Nvidia disclose about AI regulation?"

当你第一次询问一家公司的文件时，Tōshi会下载并索引它们。后续查询是即时的。

______________________________________________________________________

数据源

所有数据都直接从 SEC EDGAR REST API公司:

• www.sec.gov/files/company_tickers.json --公司搜索
• data.sec.gov/submissions/ --归档历史
• data.sec.gov/api/xbrl/companyfacts/ --财务数据
• www.sec.gov/Archives/edgar/ --实际归档文件

没有第三方API。没有付费服务。电子邮件地址之外没有API密钥。

______________________________________________________________________

备注

• 对新公司的首次查询会下载并索引他们的文件——这需要15-30秒
• 后续查询很快——数据在本地缓存
• 归档文本（10-K文档）在本地矢量数据库中进行索引，不会发送到任何地方
• 仅支持在SEC EDGAR上市的美国上市公司