fluvie MCP server

Fluvie MCP服务器

Fluvie视频合成库的模型上下文协议服务器。提供基于AI的文档搜索、代码生成和模板建议。

相关项目

快速开始

地方发展

# Install dependencies
dart pub get

# Run the server
dart run bin/server.dart

服务器启动时间 http://localhost:8080

码头工人

# Build and run
docker-compose up -d

# With HTTPS (Traefik)
docker-compose --profile with-proxy up -d

端点

MCP工具

搜索文档

使用TF-IDF排名搜索Fluvie文档。

{
  "query": "animate text opacity",
  "category": "widgets",
  "limit": 5
}

getTemplate

获取有关模板的详细信息。

{
  "category": "intro",
  "name": "TheNeonGate"
}

建议模板

根据用例获取模板建议。

{
  "useCase": "year-end summary",
  "contentType": "stats",
  "mood": "dramatic"
}

getWidgetReference

获取小部件文档和示例。

{
  "widgetName": "AnimatedProp"
}

生成代码

从自然语言生成Fluvie代码。

{
  "description": "Create an intro with a neon portal effect",
  "type": "scene",
  "fps": 30,
  "aspectRatio": "16:9"
}

MCP资源

客户端配置

克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "fluvie": {
      "url": "https://mcp.fluvie.dev/mcp",
      "transport": "http"
    }
  }
}

VS代码（Continue.dev）

{
  "models": [...],
  "mcpServers": {
    "fluvie": {
      "url": "https://mcp.fluvie.dev/mcp"
    }
  }
}

自托管

{
  "mcpServers": {
    "fluvie": {
      "url": "http://localhost:8080/mcp",
      "transport": "http"
    }
  }
}

配置

复制 .env.example 到 .env 并配置：

# Server port
PORT=8080

# Documentation path
DOCS_PATH=../doc

# Logging level
LOG_LEVEL=info

部署

使用Docker进行生产

# Build production image
docker build -t fluvie-mcp:latest .

# Run with documentation volume
docker run -d \
  -p 8080:8080 \
  -v /path/to/docs:/app/data/docs:ro \
  --name fluvie-mcp \
  fluvie-mcp:latest

使用Traefik（HTTPS）

# Set your email for Let's Encrypt
export ACME_EMAIL=you@example.com

# Start with proxy profile
docker-compose --profile with-proxy up -d

发展

项目结构

mcp-server/
├── bin/server.dart           # Main entry point
├── lib/
│   ├── mcp_server.dart       # Library exports
│   └── src/
│       ├── config/           # Server configuration
│       ├── mcp/              # MCP protocol handling
│       ├── tools/            # MCP tool implementations
│       ├── indexing/         # Documentation indexer
│       └── middleware/       # HTTP middleware
├── data/docs/                # Documentation files
├── Dockerfile
└── docker-compose.yml

添加新工具

1. 在中创建工具文件 lib/src/tools/
2. 执行工具功能
3. 注册 bin/server.dart

// lib/src/tools/my_tool.dart
ToolDefinition createMyTool() {
  return ToolDefinition(
    name: 'myTool',
    description: 'My custom tool',
    inputSchema: {...},
    handler: (args) async {
      // Implementation
      return {'result': 'data'};
    },
  );
}

许可证

MIT许可证-有关详细信息，请参阅许可证文件。