Fluent MCP Agent

流畅的MCP代理

WordPress的智能AI代理，与模型上下文协议（MCP）集成，通过AI助手提供聊天功能和执行WordPress功能。支持多个AI提供商，包括Ollama（本地）、OpenAI（ChatGPT）和Anthropic（Claude）。

🎯 概述

Fluent MCP Agent是一个WordPress插件，它将AI驱动的聊天功能直接带入您的WordPress管理面板。它是人工智能模型和WordPress的能力API之间的桥梁，允许人工智能助手发现和执行WordPress的功能作为工具。

主要特点：

• 🤖 多提供商人工智能支持（Ollama、OpenAI、Anthropic）
• 💬 WordPress管理员中的交互式聊天界面
• 🔧 通过MCP自动发现WordPress功能
• 🔄 实时对话的流式响应
• 🛠️ AI模型的工具/函数调用支持
• 🌐 Ollama提供线下首次支持
• 🔐 安全身份验证和权限处理

📋 需求

• WordPress：6.9+（用于API支持能力）
• PHP：7.4或更高
• 作曲家：用于依赖关系管理
• Node.js和npm：用于前端开发（可选，用于构建资产）

可选依赖关系

• 奥拉马：用于本地AI模型支持(安装指南)
• OpenAI API密钥：用于ChatGPT集成
• 无烟煤API密钥：用于克劳德整合

🚀 安装

1.通过Composer安装

cd wp-content/plugins/fluent-mcp-agent
composer install

2.构建前端资产（可选）

如果你想修改前端或从源代码构建：

cd my-assistant-app
npm install
npm run build

3.激活插件

1. 首选 WordPress管理员→ 插件
2. 找到 流畅的MCP代理
3. 点击 激活

⚙️ 配置

初始设置

1. 引导到 流畅的MCP代理→ 设置 在WordPress管理员
2. 启用至少一个AI提供程序
3. 配置特定于提供商的设置
4. 设置默认提供程序

提供程序配置

Ollama（本地AI）

最适合：以隐私为中心，线下优先的人工智能交互

1. 安装Ollama：从下载 奥拉玛
2. 启动Ollama：运行 ollama serve 在您的终端
3. 拉一个模型: ollama pull llama2 （或您喜欢的任何型号）
4. 启用Ollama 在插件设置中
5. 配置URL：默认值为 http://localhost:11434/api/chat

可用型号:

• llama2, llama3
• mistral, mixtral
• codellama
• phi
• 还有更多来自 Ollama图书馆

OpenAI（ChatGPT）

最适合：与GPT-4、GPT-3.5一起生产使用

1. 获取API密钥：参观 OpenAI平台
2. 启用OpenAI 在插件设置中
3. 输入API密钥：粘贴密钥（以开头 sk-)
4. API URL：默认值为 https://api.openai.com/v1/chat/completions

可用型号:

• gpt-4o
• gpt-4-turbo
• gpt-4
• gpt-3.5-turbo

人类学（克劳德）

最适合：高级推理和长上下文

1. 获取API密钥：参观 拟人控制台
2. 启用Anthropic 在插件设置中
3. 输入API密钥：粘贴密钥（以开头 sk-ant-)
4. API URL：默认值为 https://api.anthropic.com/v1/messages

可用型号:

• claude-3-opus-20240229
• claude-3-sonnet-20240229
• claude-3-haiku-20240307
• claude-3-5-sonnet-20241022

📖 使用指南

使用聊天界面

1. 引导到 流畅的MCP代理→ Chat 在WordPress管理员
2. 选择您首选的AI提供商和型号
3. 开始聊天！AI可以：

- 回答有关WordPress网站的问题 - 执行WordPress功能（如果可用） - 帮助创建内容 - 提供技术援助

WordPress能力集成

Fluent MCP代理自动发现并公开通过abilities API注册的WordPress功能。这些能力成为人工智能在对话中可以调用的工具。

示例能力 （来自流利能力中心）：

• fluentcart/get-orders -检索订单信息
• fluentcart/create-coupon -创建折扣优惠券
• fluentcart/update-order-status -更新订单状态
• 还有更多。..

前端集成

该插件包含一个全局JavaScript文件(assets/global.js)当在前端选择文本时，会添加一个“Ask Fluent”按钮。这允许用户快速询问有关所选内容的问题。

用法:

1. 在WordPress网站上选择任何文本
2. 点击“Ask Fluent”弹出按钮
3. 自定义事件 fluent:ask 与所选文本一起发送

🏗️ 建筑

插件结构

fluent-mcp-agent/
├── fluent-mcp-agent.php    # Main plugin file
├── includes/
│   ├── admin-menu.php      # Admin menu and page rendering
│   ├── settings.php        # Settings page and fields
│   ├── mcp-servers.php     # MCP server management
│   ├── ajax.php            # AJAX handlers
│   └── helpers.php         # Helper functions
├── assets/
│   ├── global.js           # Frontend integration script
│   ├── index.css           # Styles
│   └── index.js            # Additional scripts
├── my-assistant-app/       # React chat application
│   ├── src/
│   │   ├── ChatShell.jsx   # Main chat component
│   │   ├── AssistantModal.jsx
│   │   └── components/
│   └── dist/               # Built assets
└── vendor/                 # Composer dependencies
    └── wordpress/
        └── mcp-adapter/    # MCP protocol adapter

运作原理

User Input (Chat)
    ↓
React Chat Interface
    ↓
REST API: /fluent-mcp-agent/v1/api/chat
    ↓
Provider Proxy (Ollama/OpenAI/Claude)
    ↓
AI Model (with WordPress abilities as tools)
    ↓
Tool Call Detection
    ↓
WordPress Abilities API
    ↓
Execute Ability
    ↓
Return Result to AI
    ↓
Stream Response to User

关键组件

1. 提供商代理：处理与不同AI提供商的沟通
2. 流媒体支持：实时响应流以获得更好的用户体验
3. 工具/函数调用：将WordPress功能转换为AI工具格式
4. MCP集成：用途 wordpress/mcp-adapter 将API能力桥接到MCP协议

🔧 发展

设置开发环境

1. 克隆/下载 插件

1. 安装依赖项:

   composer install
   cd my-assistant-app && npm install

1. 启动开发服务器 （前端）：

   cd my-assistant-app
   npm run dev

该插件将自动检测Vite-dev服务器 http://localhost:5174/

1. 为生产而建:

   cd my-assistant-app
   npm run build

编码结构

添加新提供者

1. 在中添加提供者选项 includes/settings.php
2. 在中创建代理函数 fluent-mcp-agent.php （类似于 ollama_proxy_chat, openai_proxy_chat)
3. 在中添加提供者案例 fluent_mcp_agent_determine_provider_proxy_chat()
4. 更新管理菜单以在模型选择器中显示提供者

自定义聊天界面

React应用程序在 my-assistant-app/src/.关键文件：

• ChatShell.jsx：主要聊天组件
• utils/ChatTransportWithProvider.js：处理API通信
• components/：UI组件

REST API端点

聊天端点

发布 /wp-json/fluent-mcp-agent/v1/api/chat

请求正文:

{
  "provider": "ollama",
  "model": "llama2",
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ]
}

响应：流式文本/纯格式（辅助ui协议）

🐛 故障排除

聊天未加载

• 检查：“设置”中至少启用了一个提供程序
• 检查：已选择默认提供程序
• 检查：JavaScript错误的浏览器控制台
• 检查：可以访问REST API(/wp-json/)

Ollama连接问题

• 验证：Ollama正在奔跑(ollama serve)
• 测试: curl http://localhost:11434/api/tags 应该返回模型
• 检查：设置中的URL与您的Ollama实例匹配
• 防火墙：确保端口11434可访问

OpenAI/Claude API错误

• 验证：API密钥正确且处于活动状态
• 检查：API密钥具有足够的信用/配额
• 验证：API URL正确（默认值应该有效）
• 检查：网络/防火墙允许出站HTTPS

能力不可用

• 需要：WordPress 6.9+能力API
• 需要：能力必须通过以下方式注册 wp_register_ability()
• 检查：MCP适配器已正确初始化
• 验证：能力注册于 wp_abilities_api_init 钩子

前端构建问题

• 清除：删除 my-assistant-app/dist/ 并重建
• 检查：Node.js版本（建议18+）
• 重新安装: rm -rf node_modules && npm install
• 检查：如果使用开发模式，Vite-dev服务器正在运行

🔐 安全

• API密钥：安全地存储在WordPress选项中（在数据库中加密）
• 权限：聊天界面需要 manage_options 能力
• REST API：使用WordPress REST API身份验证
• 能力执行：尊重WordPress能力权限回调
• 用户上下文：工具调用以管理员权限执行（用于能力执行）

📝 更新日志

版本0.1.0

• 初始版本
• 支持Ollama、OpenAI和Anthropic
• 基于React的聊天界面
• WordPress能力API集成
• 流媒体响应支持
• 工具/函数调用支持

🤝 贡献

欢迎投稿！拜托：

1. 克隆该仓库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

📄 许可证

GPL v2或更高版本

🔗 相关项目

• WordPress能力API：内置WordPress 6.9+功能
• MCP适配器: wordpress/mcp-adapter 包裹
• 流利能力中心：为Fluent产品注册功能的WordPress插件
• 奥拉马：本地AI模型运行器

💡 提示和最佳实践

1. 从Ollama开始：非常适合在没有API成本的情况下进行测试
2. 使用GPT-4进行生产：最佳工具调用支持
3. 监控API使用情况：跟踪OpenAI/Claude的API成本
4. 测试能力：确保在使用前正确注册能力
5. 发展模式：使用Vite-dev服务器进行更快的前端迭代

🆘 支持

对于问题、疑问或功能请求：

• 检查上面的故障排除部分
• 查看WordPress和插件错误日志
• 确保满足所有要求
• 验证提供程序配置

______________________________________________________________________

由以下材料制成❤️ WordPress社区