Waifuverse MCP Server

WaifuVerse

WaifuVerse

外富为莱富 -你的AI伴侣终于可以做的不仅仅是聊天了！

尼亚~！在www.waifuverse.ai上创建一个帐户，让Mochi引导您完成设置（假设一切正常）

WaifuVerse就像SillyTavern和其他AI伴侣平台一样，但拥有超能力。你的外夫不只是聊天，她实际上可以做事情。生成图像、运行自动化、调用API。..你的外夫可以管理你的莱夫。下面是一个符合MCP的系统，可以让你给你的AI伴侣真正的能力。我们支持热加载等，而不需要不断更新MCP工具的一些繁琐开销。

首先，克隆repo，执行Python-env操作，在Home/mochi.py中设置OPENROUTER API KEY（或其他），并将本地Python服务器连接到主服务器（请参见runServer）。我们给你所有的源代码来构建你自己的工具调用聊天机器人，就像克劳德或其他什么

\*请注意，每当创建新聊天时，都会运行Home/game.py，并将默认聊天工具设置为Home/mochi.py

WaifuVerse网络

每个MCP服务器都是人工智能代理和开发人员协作网络的一部分。使用模型上下文协议，该平台创建了一个生态系统，在这个生态系统中，代理可以在网络中发现和使用彼此的能力。工具和功能可以在代理之间共享、发现和协调。网络架构使代理能够找到并利用其他用户的工具，从而创建一个共享功能的去中心化生态系统。

该项目的核心是一个Python MCP主机（称为“远程”），它允许您动态安装函数和第三方MCP工具

快速开始

1. 先决条件-需要为服务器安装Python，为MCP客户端安装Node；您还应该安装uv/uvx和node/npx，因为MCP似乎需要两者

1. 由于异步支持，Python 3.13现在似乎是最稳定的

1. 在中编辑runServer脚本 python-server 文件夹并设置电子邮件和服务名称（实际上，最佳做法是创建一个副本“runServerFoo”，您可以在我们进行更新时用它替换runServer文件）：

python server.py  \
  --email=youremail@gmail.com  \             # email you use for waifuverse
  --api-key=foobar \                         # should change online
  --host=localhost \                         # npx MCP will be looking here to connect to remote (assumes there is at least one running locally)
  --port=8000  \
  --cloud-host=wss://waifuverse.ai  \        # points to cloud
  --cloud-port=443  \
  --service-name=home                        # remote name, can be anything but must be unique across all machines

1. 要将其用作常规的独立MCP服务器，请将以下配置添加到Windsurf或Cursor或其他任何服务器中：

   "mcpServers": {
      "waifuverse": {
         "command": "npx",
         "args": [
            "atlantis-mcp",
            "--port",
            "8000"
            ]
      }
   }

要将WaifuVerse添加到Claude Code中，这应该有效：

claude mcp add waifuverse -- npx atlantis-mcp --port 8000

1. 要连接到WaifuVerse，请登录https://www.waifuverse.ai在同一封电子邮件下

1. 您的远程设备应使用电子邮件和默认api key='foobar'自动连接（请参阅稍后生成新密钥的'api'命令）。除非您稍后手动更改，否则将为要连接的第一台服务器分配“默认”服务器

1. 最初，除了一些示例外，函数和服务器文件夹将为空

1. 您可以运行这个独立的MCP，也可以从云端访问，或者两者兼而有之

建筑

警告：MCP术语已经很糟糕了，称之为“服务器”或“主机”只会让人更加困惑，因为MCP本质上就是p2p

系统部件：

• 云：WaifuVerse云服务器；一个与社区分享工具和废物的地方
• 远程：此仓库中的Python服务器进程，正式称为MCP“主机”（您可以在同一台机器或不同的机器上运行>1，只需指定不同的服务名称）
• 动态函数：你编写的一个简单的Python函数，充当一个工具
• 动态MCP服务器：任何第三方MCP，存储为JSON配置文件

design

请注意，MCP身份验证和安全性仍在研究中，因此现在使用云进行身份验证更容易

目录

1. Python远程（MCP P2P服务器） (python-server/)

- 我们的“远程”位置。在本地运行，但可以远程控制

1. MCP客户端 (client/)

- 让您像对待其他MCP一样对待遥控器 - 使用npx（易于安装到claude或cursor中） - 不需要云连接-尽管它可能会抱怨 - 仅支持规范的一个子集 - 只能看到本地框上的工具（至少现在）或共享的工具 工具设置为“公共”

特性

动态函数

动态函数使用户能够创建和维护作为工具的自定义函数，这些函数保存在 dynamic_functions/ 文件夹。函数在启动时加载，修改后自动重新加载。

有关创建和使用动态函数的详细信息，请参阅 动态函数文档.

动态MCP服务器

• 使用户能够安装和管理第三方MCP服务器工具；JSON配置文件保存在 dynamic_servers/ 文件夹

• 每个MCP服务器都需要先“启动”才能获取工具列表

• 每个服务器配置都遵循通常的JSON结构，其中包含一个“mcpServers”元素；例如：

  {
     "mcpServers": {
        "my-tool": {
           "command": "uvx",
           "args": [
           "--from",
           "some-mcp-package",
           "start-server",
           "--api-key",
           ""
           ]
        }
     }
  }

云

云服务在https://www.waifuverse.ai提供了一个集中式中心，用于管理远程服务器和跨机器共享工具。

应用程序组织

动态功能通过以下方式组织到应用程序中 文件夹结构。只需放置您的 .py 子目录中的文件：

dynamic_functions/
├── Home/                    # App: "Home"
│   └── mochi.py
├── Games/                   # App: "Games"
│   ├── trivia.py
│   └── rpg.py
└── ImageGen/               # App: "ImageGen"
    └── generate.py

文件夹名称就是应用程序名称。 功能在 Home 相应地分配文件夹。

嵌套应用程序（子文件夹）

使用子文件夹创建嵌套应用程序结构：

dynamic_functions/
└── MyApp/
    └── SubModule/
        └── Feature/
            └── my_function.py

这将创建应用程序名称： MyApp/SubModule/Feature

最佳实践：

• 保持简单——一级文件夹通常就足够了
• 使用描述性文件夹名称（例如。， Chat, Admin, Tools)
• 将相关功能组合在同一文件夹中
• 文件夹结构使您的代码保持有序和清晰

注： 遗产 @app(name="...") 装饰师还在工作，但 不推荐 因为当装饰器与文件夹位置不匹配时，可能会造成混淆。只需使用文件夹！

使用搜索词调用工具

调用工具时，您可以使用 复合工具名称 以消除功能歧义。 仅包含唯一标识函数所需的路径。

格式： remote_owner*remote_name*app*location*function

关键原则：使用唯一解析的最简单形式

# If you have these functions:
# - dynamic_functions/Chat/send_message.py
# - dynamic_functions/Email/send_message.py
# - dynamic_functions/SMS/send_message.py

send_message              ❌ Ambiguous! Which one?
**Chat**send_message      ✅ Clear! The one in Chat
**Email**send_message     ✅ Clear! The one in Email

示例：

update_image                          → Simple call (only works if unique)
**MyApp**update_image                 → Specify app to disambiguate
**MyApp/SubModule**process_data       → Nested app path
alice*prod*Admin**restart             → Full routing: owner + remote + app + function
***office*print                       → Just location context

它是如何工作的：

• 领域： remote_owner*remote_name*app*location*function
• 用以下内容分隔字段 * （星号）
• 省略不需要的字段 （使用空字符串： **App**func)
• 应用程序字段支持嵌套应用程序的斜线表示法(MyApp/SubModule)
• 最后一个字段始终是函数名
• 无星号=将整个名称视为函数名称

何时使用化合物名称：

• 名称冲突：多个应用程序具有同名功能
• 远程定位：从云端调用特定遥控器上的功能
• 位置路线：特定物理位置的目标功能
• 多用户设置：在共享环境中指定所有者和远程

最佳实践： 简单开始(update_image)仅在需要解决歧义时添加上下文(**ImageTools**update_image).

例子：

# File: dynamic_functions/ImageTools/process.py
@visible
async def update_image(image_path: str):
    """Update an image."""
    return "updated"

# If this is the ONLY update_image:
update_image                          ✅ Works fine!

# If Chat app ALSO has update_image:
**ImageTools**update_image            ✅ Now we need to specify the app