AI导哈

TOEIC文章生成器

基于FastAPI的MCP服务，为TOEIC学习者生成结构化的英语学习新闻文章，集成OpenAI兼容语言模型并提供干净的JSON输出。

  • by 0xshivainu
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 0xshivainu/EnglishArticleAgent-MCP-APP

使用说明

📰 FastAPI MCP TOEIC文章生成器

基于FastAPI的 MCP（模型上下文协议） 为托业学习者生成结构化英语学习新闻文章的服务。
该服务与OpenAI兼容的语言模型集成，并提供专为web渲染设计的干净JSON输出。

🚀 特性

  • 生成逼真的托业风格英语新闻文章
  • 返回结构化JSON（元数据、文章和评论）
  • 已准备好进行MCP集成或独立使用API
  • 包括用于手动测试的响应式web界面
  • 可通过Docker或Render部署

🧩 目录结构

├── main.py#核心FastAPI MCP服务器 ├── requirements.txt#Python依赖项 ├── Dockerfile#容器部署的构建说明 ├── docker-compose.yml#本地测试/容器编排 ├── config.py/#包含用于调用.env文件的API配置 └── index.html#（可选）简单web客户端（前端）

⚙️ 设置和安装

1.克隆并进入项目目录

git clone https://github.com/0xshivainu/EnglishArticleAgent-MCP-APP.git
cd EnglishArticleAgent-MCP-APP

2.安装依赖项

pip install -r requirements.txt

3.配置环境

创建文件 config/settings.py 并定义您的OpenAI兼容设置：

from pydantic_settings import BaseSettings

class Settings(BaseSettings):
api_key: str = "YOUR_API_KEY"
base_url: str = "https://api.openai.com..."

settings = Settings()

▶️ 在本地运行

使用Uvicorn

python main.py

或者使用Docker Compose（mac）

docker compose up --build

服务器将在以下位置可用：
👉 http://0.0.0.0:10000

🌐 API终点

健康检查

GET/健康

答复：

{
    "status": "healthy",
    "service": "simple-mcp"
}

生成文章

POST/生成_文章

请求体

{
    "topic": "artificial intelligence in the workplace"
}

cURL命令示例

curl -X POST "https://0.0.0.0:10000/generate_article"
-H "Content-Type: application/json"
-d '{"topic": "artificial intelligence in the workplace"}'

相关 MCP