knowfun-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Knowfun.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,307 @@
+# Knowfun MCP Server
+
+[![NPM Version](https://img.shields.io/npm/v/knowfun-mcp?style=flat-square)](https://www.npmjs.com/package/knowfun-mcp)
+[![License](https://img.shields.io/npm/l/knowfun-mcp?style=flat-square)](LICENSE)
+[![Node Version](https://img.shields.io/node/v/knowfun-mcp?style=flat-square)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue?style=flat-square)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-1.0.4-green?style=flat-square)](https://modelcontextprotocol.io/)
+
+[中文](./README.zh.md) | English
+
+This is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that wraps the Knowfun.io OpenAPI, allowing AI assistants (like Claude) to directly invoke Knowfun's content generation capabilities.
+
+## Features
+
+Through this MCP server, AI assistants can:
+
+- ✅ Create content generation tasks (courses, posters, games, films)
+- ✅ Query task status and detailed results
+- ✅ Get task lists (with pagination and filtering)
+- ✅ Query credit balance and usage details
+- ✅ Get API configuration schema (all available generation options)
+
+## Installation
+
+```bash
+# Clone or navigate to project directory
+cd knowfun-mcp
+
+# Install dependencies
+npm install
+
+# Compile TypeScript
+npm run build
+```
+
+## Configuration
+
+1. Copy environment variable template:
+```bash
+cp .env.example .env
+```
+
+2. Edit `.env` file and fill in your Knowfun API Key:
+```bash
+KNOWFUN_API_KEY=kf_your_api_key_here
+KNOWFUN_API_BASE_URL=https://api.knowfun.io
+```
+
+> 💡 How to get API Key?
+> 1. Login to [knowfun.io](https://knowfun.io)
+> 2. Go to `/api-platform` page
+> 3. Create or view your API Key
+
+3. Test connection (optional but recommended):
+```bash
+npm test
+```
+
+If configured correctly, it will show:
+- ✅ API Key valid
+- ✅ Network connection normal
+- ✅ Current credit balance
+
+## Use in Claude Desktop
+
+Edit Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add the following configuration:
+
+```json
+{
+  "mcpServers": {
+    "knowfun": {
+      "command": "node",
+      "args": ["/Users/jamson/code/knowfun-mcp/dist/index.js"],
+      "env": {
+        "KNOWFUN_API_KEY": "kf_your_api_key_here",
+        "KNOWFUN_API_BASE_URL": "https://api.knowfun.io"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop to use Knowfun tools.
+
+## Use in Claude Code (CLI)
+
+Create or edit `~/.config/claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "knowfun": {
+      "command": "node",
+      "args": ["/Users/jamson/code/knowfun-mcp/dist/index.js"],
+      "env": {
+        "KNOWFUN_API_KEY": "kf_your_api_key_here",
+        "KNOWFUN_API_BASE_URL": "https://api.knowfun.io"
+      }
+    }
+  }
+}
+```
+
+Then use Claude Code CLI as normal.
+
+## Use in Cursor
+
+Create `.cursor/mcp_config.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "knowfun": {
+      "command": "node",
+      "args": ["/Users/jamson/code/knowfun-mcp/dist/index.js"],
+      "env": {
+        "KNOWFUN_API_KEY": "kf_your_api_key_here",
+        "KNOWFUN_API_BASE_URL": "https://api.knowfun.io"
+      }
+    }
+  }
+}
+```
+
+Or configure in Cursor settings (Settings → Features → MCP).
+
+## Available Tools
+
+### 1. create_task
+Create content generation task (API: `POST /api/openapi/v1/tasks`)
+
+**Parameters**:
+- `requestId` (string, required): Custom request ID (1-64 characters)
+- `taskType` (string, required): Task type - `course`, `poster`, `game`, `film`
+- `material` (object, required): Input material
+  - `text` (string): Text content
+  - `url` (string): Document or webpage URL
+  - `type` (string): Material type (text, url, pdf, doc, etc.)
+- `config` (object): Generation config (optional, call `get_schema` first to see available options)
+- `callbackUrl` (string): Callback URL on completion (optional)
+- `language` (string): Language setting (optional)
+
+**Example**:
+```json
+{
+  "requestId": "req-20260301-001",
+  "taskType": "course",
+  "material": {
+    "text": "Introduction to AI: AI is a branch of computer science...",
+    "type": "text"
+  },
+  "config": {
+    "course": {
+      "contentLanguage": "en",
+      "explainLanguage": "en",
+      "aspectRatio": "landscape"
+    }
+  }
+}
+```
+
+### 2. get_task
+Query task status by taskId (API: `GET /api/openapi/v1/tasks/:taskId`)
+
+**Parameters**:
+- `taskId` (string, required): Task ID
+
+### 3. get_task_by_request_id
+Query task status by requestId (API: `GET /api/openapi/v1/tasks/by-request/:requestId`)
+
+**Parameters**:
+- `requestId` (string, required): Request ID
+
+### 4. get_task_detail
+Get detailed task information (API: `GET /api/openapi/v1/tasks/:taskId/detail`)
+
+**Parameters**:
+- `taskId` (string, required): Task ID
+- `verbose` (boolean): Return detailed debug info (default false)
+
+### 5. list_tasks
+Get task list (API: `GET /api/openapi/v1/tasks`)
+
+**Parameters**:
+- `page` (number): Page number (default 1)
+- `limit` (number): Items per page (default 20)
+- `status` (string): Status filter (pending, processing, success, failed)
+- `taskType` (string): Type filter (course, poster, game, film)
+
+### 6. get_credits_balance
+Query current API Key credit balance (API: `GET /api/openapi/v1/credits/balance`)
+
+**Returns**:
+- `available`: Available credits
+- `earned`: Total earned credits
+- `used`: Used credits
+- `locked`: Locked credits
+
+### 7. get_credits_pricing
+Get credit pricing for each task type (API: `GET /api/openapi/v1/credits/pricing`)
+
+### 8. get_schema
+Get API configuration schema (API: `GET /api/openapi/v1/schema`)
+
+Includes all available content styles, templates, languages, etc.
+
+### 9. get_usage
+Query credit usage details (API: `GET /api/openapi/usage`)
+
+**Parameters**:
+- `startDate` (string): Start date (YYYY-MM-DD)
+- `endDate` (string): End date (YYYY-MM-DD)
+
+## Task Types
+
+### Course
+Generate multimedia course content (video, PPT, etc.)
+
+**Main config**:
+- `contentStyle`: Content style (concise, detailed, etc.)
+- `contentLanguage`: Content language
+- `explainLanguage`: Narration language
+- `voiceType`: Voice type
+- `aspectRatio`: Aspect ratio (landscape, portrait)
+
+### Poster
+Generate knowledge infographic posters
+
+**Main config**:
+- `usage`: Layout type (infographic, businessReports, etc.)
+- `style`: Art style (handDrawn, photorealistic, etc.)
+- `aspectRatio`: Aspect ratio (1:1, 4:3, 16:9, etc.)
+
+### Game
+Generate interactive game content
+
+**Main config**:
+- `gameType`: Game type (story, interactive, mission, etc.)
+- `aspectRatio`: Aspect ratio
+
+### Film
+Generate short videos or micro-films
+
+**Main config**:
+- `filmStyle`: Film style (story, documentary, tutorial, etc.)
+- `aspectRatio`: Aspect ratio (16:9, 9:16, 1:1)
+
+## Development
+
+```bash
+# Watch file changes and auto-compile
+npm run watch
+
+# Run in development mode
+npm run dev
+```
+
+## Tech Stack
+
+- **MCP SDK**: @modelcontextprotocol/sdk
+- **HTTP Client**: axios
+- **Language**: TypeScript
+- **Runtime**: Node.js
+
+## Documentation
+
+### Quick Start
+- 🚀 [QUICKSTART.md](./QUICKSTART.md) - Quick Start Guide
+- 🚀 [QUICKSTART.zh.md](./QUICKSTART.zh.md) - 快速入门指南
+
+### Complete Documentation
+- 📖 [README.md](./README.md) - Complete Documentation (English)
+- 📖 [README.zh.md](./README.zh.md) - 完整项目文档（中文）
+- 📝 [USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md) - Usage Examples
+- 📝 [USAGE_EXAMPLES.zh.md](./USAGE_EXAMPLES.zh.md) - 使用示例
+- ⚙️ [CONFIGURATION.md](./CONFIGURATION.md) - Configuration Guide (Bilingual)
+
+### Reference
+- 📊 [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md) - Project Structure
+- 📋 [CHANGELOG.md](./CHANGELOG.md) - Version History
+
+### Contributing
+- 🤝 [CONTRIBUTING.md](./CONTRIBUTING.md) - How to Contribute
+- 📜 [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) - Code of Conduct
+- 🔒 [SECURITY.md](./SECURITY.md) - Security Policy
+
+## Related Links
+
+- [Knowfun.io](https://knowfun.io)
+- [Knowfun OpenAPI Docs](https://knowfun.io/api-platform)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Claude Desktop](https://claude.ai/download)
+- [Claude Code CLI](https://docs.anthropic.com/claude/docs/claude-code)
+- [Cursor](https://cursor.sh)
+
+## License
+
+MIT
+
+## Support
+
+For issues or suggestions, please contact the Knowfun team or submit an Issue.

package/README.zh.md

@@ -0,0 +1,311 @@
+# Knowfun MCP Server
+
+[![NPM Version](https://img.shields.io/npm/v/knowfun-mcp?style=flat-square)](https://www.npmjs.com/package/knowfun-mcp)
+[![License](https://img.shields.io/npm/l/knowfun-mcp?style=flat-square)](LICENSE)
+[![Node Version](https://img.shields.io/node/v/knowfun-mcp?style=flat-square)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue?style=flat-square)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/MCP-1.0.4-green?style=flat-square)](https://modelcontextprotocol.io/)
+
+中文 | [English](./README.md)
+
+这是一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 的服务器，用于封装 Knowfun.io 的 OpenAPI，让 AI 助手（如 Claude）能够直接调用 Knowfun 的内容生成能力。
+
+## 功能特性
+
+通过此 MCP server，AI 助手可以：
+
+- ✅ 创建内容生成任务（课程、海报、游戏、短剧）
+- ✅ 查询任务状态和详细结果
+- ✅ 获取任务列表（支持分页和筛选）
+- ✅ 查询积分余额和消耗明细
+- ✅ 获取 API 配置 Schema（所有可用的生成选项）
+
+## 安装
+
+```bash
+# 克隆或进入项目目录
+cd knowfun-mcp
+
+# 安装依赖
+npm install
+
+# 编译 TypeScript
+npm run build
+```
+
+## 配置
+
+1. 复制环境变量模板：
+```bash
+cp .env.example .env
+```
+
+2. 编辑 `.env` 文件，填入您的 Knowfun API Key：
+```bash
+KNOWFUN_API_KEY=kf_your_api_key_here
+KNOWFUN_API_BASE_URL=https://api.knowfun.io
+```
+
+> 💡 如何获取 API Key？
+> 1. 登录 [knowfun.io](https://knowfun.io)
+> 2. 进入 `/api-platform` 页面
+> 3. 创建或查看您的 API Key
+
+3. 测试连接（可选但推荐）：
+```bash
+npm test
+```
+
+如果配置正确，会显示：
+- ✅ API Key 有效
+- ✅ 网络连接正常
+- ✅ 当前积分余额
+
+## 使用配置
+
+### 在 Claude Desktop 中使用
+
+编辑 Claude Desktop 的配置文件：
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+添加以下配置：
+
+```json
+{
+  "mcpServers": {
+    "knowfun": {
+      "command": "node",
+      "args": ["/Users/jamson/code/knowfun-mcp/dist/index.js"],
+      "env": {
+        "KNOWFUN_API_KEY": "kf_your_api_key_here",
+        "KNOWFUN_API_BASE_URL": "https://api.knowfun.io"
+      }
+    }
+  }
+}
+```
+
+重启 Claude Desktop 后，即可使用 Knowfun 工具。
+
+### 在 Claude Code (CLI) 中使用
+
+编辑或创建 `~/.config/claude/settings.json`：
+
+```json
+{
+  "mcpServers": {
+    "knowfun": {
+      "command": "node",
+      "args": ["/Users/jamson/code/knowfun-mcp/dist/index.js"],
+      "env": {
+        "KNOWFUN_API_KEY": "kf_your_api_key_here",
+        "KNOWFUN_API_BASE_URL": "https://api.knowfun.io"
+      }
+    }
+  }
+}
+```
+
+然后正常使用 Claude Code CLI 即可。
+
+### 在 Cursor 中使用
+
+在项目根目录创建 `.cursor/mcp_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "knowfun": {
+      "command": "node",
+      "args": ["/Users/jamson/code/knowfun-mcp/dist/index.js"],
+      "env": {
+        "KNOWFUN_API_KEY": "kf_your_api_key_here",
+        "KNOWFUN_API_BASE_URL": "https://api.knowfun.io"
+      }
+    }
+  }
+}
+```
+
+或在 Cursor 设置中配置（Settings → Features → MCP）。
+
+> 📖 查看 [CONFIGURATION.md](./CONFIGURATION.md) 获取详细配置指南
+
+## 可用工具
+
+### 1. create_task
+创建内容生成任务（API: `POST /api/openapi/v1/tasks`）
+
+**参数**：
+- `requestId` (string, 必需): 自定义请求ID（1-64字符）
+- `taskType` (string, 必需): 任务类型 - `course`（课程）, `poster`（海报）, `game`（游戏）, `film`（短剧）
+- `material` (object, 必需): 输入素材
+  - `text` (string): 文本内容
+  - `url` (string): 文档或网页URL
+  - `type` (string): 素材类型（text, url, pdf, doc等）
+- `config` (object): 生成配置（可选，建议先调用 `get_schema` 查看可用配置）
+- `callbackUrl` (string): 完成回调URL（可选）
+- `language` (string): 语言设置（可选）
+
+**示例**：
+```json
+{
+  "requestId": "req-20260301-001",
+  "taskType": "course",
+  "material": {
+    "text": "人工智能简介：AI是计算机科学的一个分支...",
+    "type": "text"
+  },
+  "config": {
+    "course": {
+      "contentLanguage": "zh",
+      "explainLanguage": "zh",
+      "aspectRatio": "landscape"
+    }
+  }
+}
+```
+
+### 2. get_task
+根据 taskId 查询任务状态（API: `GET /api/openapi/v1/tasks/:taskId`）
+
+**参数**：
+- `taskId` (string, 必需): 任务ID
+
+### 3. get_task_by_request_id
+根据 requestId 查询任务状态（API: `GET /api/openapi/v1/tasks/by-request/:requestId`）
+
+**参数**：
+- `requestId` (string, 必需): 请求ID
+
+### 4. get_task_detail
+获取任务详细信息（API: `GET /api/openapi/v1/tasks/:taskId/detail`）
+
+**参数**：
+- `taskId` (string, 必需): 任务ID
+- `verbose` (boolean): 是否返回详细调试信息（默认 false）
+
+### 5. list_tasks
+获取任务列表（API: `GET /api/openapi/v1/tasks`）
+
+**参数**：
+- `page` (number): 页码（默认 1）
+- `limit` (number): 每页数量（默认 20）
+- `status` (string): 状态筛选（pending, processing, success, failed）
+- `taskType` (string): 类型筛选（course, poster, game, film）
+
+### 6. get_credits_balance
+查询当前 API Key 的积分余额（API: `GET /api/openapi/v1/credits/balance`）
+
+**返回**：
+- `available`: 可用积分
+- `earned`: 总获得积分
+- `used`: 已使用积分
+- `locked`: 锁定积分
+
+### 7. get_credits_pricing
+获取各类任务的积分消耗定价（API: `GET /api/openapi/v1/credits/pricing`）
+
+### 8. get_schema
+获取 API 配置 Schema（API: `GET /api/openapi/v1/schema`）
+
+包括所有可用的内容风格、模板、语言等选项
+
+### 9. get_usage
+查询积分消耗明细（API: `GET /api/openapi/usage`）
+
+**参数**：
+- `startDate` (string): 开始日期（YYYY-MM-DD）
+- `endDate` (string): 结束日期（YYYY-MM-DD）
+
+## 任务类型说明
+
+### Course（课程）
+生成多媒体课程内容（视频、PPT等）
+
+**主要配置项**：
+- `contentStyle`: 内容风格（concise、detailed等）
+- `contentLanguage`: 内容语言
+- `explainLanguage`: 解说语言
+- `voiceType`: 音色类型
+- `aspectRatio`: 宽高比（landscape、portrait）
+
+### Poster（海报）
+生成知识图解海报
+
+**主要配置项**：
+- `usage`: 布局类型（infographic、businessReports等）
+- `style`: 美术风格（handDrawn、photorealistic等）
+- `aspectRatio`: 宽高比（1:1、4:3、16:9等）
+
+### Game（游戏）
+生成互动游戏内容
+
+**主要配置项**：
+- `gameType`: 游戏类型（story、interactive、mission等）
+- `aspectRatio`: 宽高比
+
+### Film（短剧）
+生成短视频或微电影
+
+**主要配置项**：
+- `filmStyle`: 影片风格（story、documentary、tutorial等）
+- `aspectRatio`: 画面比例（16:9、9:16、1:1）
+
+## 开发
+
+```bash
+# 监听文件变化并自动重新编译
+npm run watch
+
+# 运行开发模式
+npm run dev
+```
+
+## 技术栈
+
+- **MCP SDK**: @modelcontextprotocol/sdk
+- **HTTP 客户端**: axios
+- **语言**: TypeScript
+- **运行时**: Node.js
+
+## 文档
+
+### 快速开始
+- 🚀 [QUICKSTART.zh.md](./QUICKSTART.zh.md) - 快速入门指南
+- 🚀 [QUICKSTART.md](./QUICKSTART.md) - Quick Start Guide
+
+### 完整文档
+- 📖 [README.zh.md](./README.zh.md) - 完整项目文档（中文）
+- 📖 [README.md](./README.md) - Complete Documentation (English)
+- 📝 [USAGE_EXAMPLES.zh.md](./USAGE_EXAMPLES.zh.md) - 使用示例
+- 📝 [USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md) - Usage Examples
+- ⚙️ [CONFIGURATION.md](./CONFIGURATION.md) - 详细配置指南（中英文）
+
+### 参考资料
+- 📊 [PROJECT_STRUCTURE.zh.md](./PROJECT_STRUCTURE.zh.md) - 项目结构说明
+- 📋 [CHANGELOG.md](./CHANGELOG.md) - 版本更新记录
+
+### 贡献指南
+- 🤝 [CONTRIBUTING.md](./CONTRIBUTING.md) - 如何贡献代码
+- 📜 [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) - 社区行为准则
+- 🔒 [SECURITY.md](./SECURITY.md) - 安全政策
+
+## 相关链接
+
+- [Knowfun.io](https://knowfun.io)
+- [Knowfun OpenAPI 文档](https://knowfun.io/api-platform)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Claude Desktop](https://claude.ai/download)
+- [Claude Code CLI](https://docs.anthropic.com/claude/docs/claude-code)
+- [Cursor](https://cursor.sh)
+
+## 许可证
+
+MIT
+
+## 支持
+
+如有问题或建议，请联系 Knowfun 团队或提交 Issue。

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,380 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode, } from "@modelcontextprotocol/sdk/types.js";
+import axios from "axios";
+import * as dotenv from "dotenv";
+dotenv.config();
+// Knowfun API Client
+class KnowfunClient {
+    client;
+    apiKey;
+    baseURL;
+    constructor(apiKey, baseURL) {
+        this.apiKey = apiKey;
+        this.baseURL = baseURL;
+        this.client = axios.create({
+            baseURL: this.baseURL,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+    }
+    // 创建任务
+    async createTask(params) {
+        const response = await this.client.post("/api/openapi/v1/tasks", params);
+        return response.data;
+    }
+    // 查询任务状态
+    async getTask(taskId) {
+        const response = await this.client.get(`/api/openapi/v1/tasks/${taskId}`);
+        return response.data;
+    }
+    // 按 requestId 查询任务
+    async getTaskByRequestId(requestId) {
+        const response = await this.client.get(`/api/openapi/v1/tasks/by-request/${requestId}`);
+        return response.data;
+    }
+    // 查询任务详情
+    async getTaskDetail(taskId, verbose = false) {
+        const response = await this.client.get(`/api/openapi/v1/tasks/${taskId}/detail`, {
+            params: { verbose },
+        });
+        return response.data;
+    }
+    // 获取任务列表
+    async listTasks(params) {
+        const response = await this.client.get("/api/openapi/v1/tasks", { params });
+        return response.data;
+    }
+    // 查询积分余额
+    async getCreditsBalance() {
+        const response = await this.client.get("/api/openapi/v1/credits/balance");
+        return response.data;
+    }
+    // 获取积分定价
+    async getCreditsPricing() {
+        const response = await this.client.get("/api/openapi/v1/credits/pricing");
+        return response.data;
+    }
+    // 获取 API Schema
+    async getSchema() {
+        const response = await this.client.get("/api/openapi/v1/schema");
+        return response.data;
+    }
+    // 查询积分消耗明细
+    async getUsage(params) {
+        const response = await this.client.get("/api/openapi/usage", { params });
+        return response.data;
+    }
+}
+// MCP Server
+const server = new Server({
+    name: "knowfun-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Initialize Knowfun client
+const apiKey = process.env.KNOWFUN_API_KEY;
+const baseURL = process.env.KNOWFUN_API_BASE_URL || "https://api.knowfun.io";
+if (!apiKey) {
+    console.error("KNOWFUN_API_KEY environment variable is required");
+    process.exit(1);
+}
+const knowfunClient = new KnowfunClient(apiKey, baseURL);
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "create_task",
+                description: "创建一个新的内容生成任务（课程、海报、游戏或短剧）",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        requestId: {
+                            type: "string",
+                            description: "用户自定义请求ID（1-64字符，用于幂等性控制）",
+                        },
+                        taskType: {
+                            type: "string",
+                            enum: ["course", "poster", "game", "film"],
+                            description: "任务类型：course-课程，poster-海报，game-游戏，film-短剧",
+                        },
+                        material: {
+                            type: "object",
+                            properties: {
+                                text: { type: "string", description: "文本内容" },
+                                url: { type: "string", description: "文档或网页URL" },
+                                type: {
+                                    type: "string",
+                                    description: "素材类型：text, url, pdf, doc, docx等",
+                                },
+                            },
+                            description: "输入素材",
+                        },
+                        config: {
+                            type: "object",
+                            description: "生成配置（根据 taskType 不同，配置项也不同。可先调用 get_schema 查看可用配置）",
+                        },
+                        callbackUrl: {
+                            type: "string",
+                            description: "任务完成后的回调URL（可选）",
+                        },
+                        language: {
+                            type: "string",
+                            description: "语言设置（可选，默认为 zh）",
+                        },
+                    },
+                    required: ["requestId", "taskType", "material"],
+                },
+            },
+            {
+                name: "get_task",
+                description: "根据 taskId 查询任务状态",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "任务ID",
+                        },
+                    },
+                    required: ["taskId"],
+                },
+            },
+            {
+                name: "get_task_by_request_id",
+                description: "根据 requestId 查询任务状态",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        requestId: {
+                            type: "string",
+                            description: "请求ID",
+                        },
+                    },
+                    required: ["requestId"],
+                },
+            },
+            {
+                name: "get_task_detail",
+                description: "获取任务的详细信息（包括生成结果）",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "任务ID",
+                        },
+                        verbose: {
+                            type: "boolean",
+                            description: "是否返回详细的调试信息（可选，默认false）",
+                            default: false,
+                        },
+                    },
+                    required: ["taskId"],
+                },
+            },
+            {
+                name: "list_tasks",
+                description: "获取任务列表（支持分页和筛选）",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        page: {
+                            type: "number",
+                            description: "页码（从1开始）",
+                            default: 1,
+                        },
+                        limit: {
+                            type: "number",
+                            description: "每页数量",
+                            default: 20,
+                        },
+                        status: {
+                            type: "string",
+                            description: "任务状态筛选：pending, processing, success, failed等",
+                        },
+                        taskType: {
+                            type: "string",
+                            description: "任务类型筛选：course, poster, game, film",
+                        },
+                    },
+                },
+            },
+            {
+                name: "get_credits_balance",
+                description: "查询当前 API Key 的积分余额",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "get_credits_pricing",
+                description: "获取各类任务的积分消耗定价",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "get_schema",
+                description: "获取 API 配置 Schema（包括所有可用的内容风格、模板、语言等选项）",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "get_usage",
+                description: "查询积分消耗明细",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        startDate: {
+                            type: "string",
+                            description: "开始日期（YYYY-MM-DD）",
+                        },
+                        endDate: {
+                            type: "string",
+                            description: "结束日期（YYYY-MM-DD）",
+                        },
+                    },
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case "create_task": {
+                const result = await knowfunClient.createTask(args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_task": {
+                const result = await knowfunClient.getTask(args?.taskId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_task_by_request_id": {
+                const result = await knowfunClient.getTaskByRequestId(args?.requestId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_task_detail": {
+                const result = await knowfunClient.getTaskDetail(args?.taskId, args?.verbose);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "list_tasks": {
+                const result = await knowfunClient.listTasks(args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_credits_balance": {
+                const result = await knowfunClient.getCreditsBalance();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_credits_pricing": {
+                const result = await knowfunClient.getCreditsPricing();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_schema": {
+                const result = await knowfunClient.getSchema();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_usage": {
+                const result = await knowfunClient.getUsage(args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            const status = error.response?.status;
+            const message = error.response?.data?.error || error.message;
+            throw new McpError(ErrorCode.InternalError, `API Error (${status}): ${message}`);
+        }
+        throw new McpError(ErrorCode.InternalError, `Error: ${error.message}`);
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Knowfun MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "knowfun-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for Knowfun.io OpenAPI - Generate courses, posters, games, and films using AI",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "knowfun-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "test": "node test-connection.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "knowfun",
+    "openapi",
+    "ai",
+    "content-generation",
+    "course-generation",
+    "poster-generation",
+    "game-generation",
+    "claude",
+    "cursor",
+    "typescript"
+  ],
+  "author": "Knowfun.io <support@knowfun.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/knowfun/knowfun-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/knowfun/knowfun-mcp/issues"
+  },
+  "homepage": "https://github.com/knowfun/knowfun-mcp#readme",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  }
+}