Thai Food Dictionary MCP Server

Ahaan Thai MCP 服务器

一个包含MCP服务器和用于ahaan-thai.de API的REST API的集合

特点/功能

• 双模式可作为本地MCP服务器（stdio）和远程HTTP MCP服务器使用
• 共享逻辑所有实现之间共享的业务逻辑
• 四个应用程序编程接口（API）词典、书籍信息、图书馆和百科全书
• 26个工具通过MCP协议访问所有功能

快速入门

一键安装（最简单）

安装 .mcpb Claude Desktop 安装包 - 拖放即装！

构建包：

npm install
npm run http-mcp:bundle:pack

这造成了 mcpb/ahaan-thai.mcpb (1.4MB)。只需拖动 .mcpb 将文件导入Claude Desktop进行安装。无需配置！

远程访问（使用mcp-remote）

使用托管的MCP服务器，位于 https://mcp.ahaan-thai.de/mcp - 无需本地设置！

看见 MCP-客户端安装指南.md 用于配置说明。

本地开发

克隆此仓库并在本地运行以进行开发或离线访问。

MCP 服务器

目前，我们为 ahaan-thai.de 提供的 API 配备了四台服务器：

字典服务器

一个用于泰国美食词典的MCP服务器。它提供了许多与食物相关的术语在泰语、英语和德语中的翻译。

• thai-food-dictionary-server (dictionary-server.js) 翻译为中文是：(字典服务器.js)

书籍信息服务器

一个用于泰国菜谱库的MCP服务器，提供作者、标题、描述、ISBN、语言、难度等级、出版商、年份等信息。

• thai-cook-book-info-server (book-info-server.js) 翻译为中文可以是：（书籍信息服务器.js）

图书馆服务器

一个针对泰国烹饪书库的MCP服务器，提供书中所含的食谱。

• thai-cook-book-library-server (library-server.js) 翻译为中文是：（库服务器.js）

百科全书服务器

一个针对泰国美食百科的MCP服务器，涵盖菜肴、食材及烹饪方法。

• thai-food-encyclopedia-server (百科全书服务器.js)

HTTP MCP 服务器（远程使用）

所有MCP功能均可通过HTTP访问，网址为 https://mcp.ahaan-thai.de/mcp

快速入门：

npm run http-mcp:start    # Start HTTP MCP server on port 3000
npm run http-mcp:dev      # Start with auto-reload
npm run http-mcp:build    # Build for deployment
npm run http-mcp:inspect  # Open MCP Inspector

见 \DEPLOYMENT.md\ 翻译为中文是：“部署说明文件”或“部署指南文件”。这里，\.md\ 是 Markdown 文件的扩展名，通常用于编写文档、说明或指南。因此，\DEPLOYMENT.md\ 可以理解为一个包含部署相关说明或指南的 Markdown 文件 用于部署说明。

先决条件

• Node.js 18.17.0 或更高版本
• 推荐使用Node版本管理器（nvm）
• 访问/获取 https://ahaan-thai.de/api/

入门指南/开始使用

1. 安装依赖项

npm install

2. 使脚本可执行

我们使用bash脚本来启动服务器，以确保使用正确的节点版本：

chmod +x run-book-info-server.sh
chmod +x run-dictionary-server.sh
chmod +x run-library-server.sh
chmod +x run-encyclopedia-server.sh

3. 启动MCP服务器

./run-dictionary-server.sh
./run-book-info-server.sh
./run-library-server.sh
./run-encyclopedia-server.sh

或者使用 npm 脚本：

npm run start:dictionary
npm run start:book-info
npm run start:library
npm run start:encyclopedia

4. 检查服务器

为了检查服务器，我们使用了来自（某处/某供应商的）检查工具 modelcontextprotocol：

npm run inspect:dictionary
npm run inspect:book-info
npm run inspect:library
npm run inspect:encyclopedia

与Claude桌面版的使用

选项1：MCPB套餐（最简单 - 推荐）

安装 .mcpb 捆绑；软件包

1. 构建： npm run http-mcp:bundle:pack
2. 拖放 mcpb/ahaan-thai.mcpb 转化为Claude桌面版
3. 重启Claude桌面版

就是这么简单！无需任何配置。

选项2：使用mcp-remote

通过使用托管的HTTP MCP服务器 mcp-remote：

对于 macOS，编辑： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ahaan-thai": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.ahaan-thai.de/mcp"
      ]
    }
  }
}

选项3：本地Studio服务器

在本地运行MCP服务器（用于开发）：

{
  "mcpServers": {
    "thai-food-dictionary": {
      "command": "bash",
      "args": ["
/run-dictionary-server.sh"]
    },
    "thai-cook-book-info": {
      "command": "bash",
      "args": ["
/run-book-info-server.sh"]
    },
    "thai-cook-book-library": {
      "command": "bash",
      "args": ["
/run-library-server.sh"]
    },
    "thai-food-encyclopedia": {
      "command": "bash",
      "args": ["
/run-encyclopedia-server.sh"]
    }
  }
}

看 MCP-客户端安装指南.md 如需详细的设置说明。

项目结构

├── src/                          # HTTP MCP Server (Development)
│   ├── index.js                  # HTTP MCP Server
│   └── lib/                      # Shared Business Logic
│       ├── cache.js
│       ├── logger.js
│       ├── dictionary-logic.js
│       ├── book-info-logic.js
│       ├── library-logic.js
│       └── encyclopedia-logic.js
│
├── dist/                         # Production Build
│   ├── index.js                  # Bundled HTTP MCP Server (37kb)
│   └── package.json              # Auto-generated
│
├── mcpb/                         # Claude Desktop Extension Bundle
│   ├── manifest.json             # Bundle configuration
│   ├── package.json              # Bundle dependencies
│   ├── icon.png                  # Extension icon
│   ├── node_modules/             # Bundled dependencies (mcp-remote)
│   └── ahaan-thai.mcpb           # Pre-built bundle (1.4MB)
│
├── dictionary-server.js          # Stdio MCP Server (uses src/lib/)
├── book-info-server.js           # Stdio MCP Server (uses src/lib/)
├── library-server.js             # Stdio MCP Server (uses src/lib/)
├── encyclopedia-server.js        # Stdio MCP Server (uses src/lib/)
│
├── run-*.sh                      # Startup scripts (ensure Node version)
├── build-dist-package.js         # Generates dist/package.json
│
├── README.md                     # This file
├── MCP-CLIENT-SETUP.md           # Client setup guide
└── CLAUDE.md                     # Development guide for Claude Code

可用脚本

Stdio MCP 服务器（本地）

# Start servers
npm run stdio:dictionary:start
npm run stdio:book-info:start
npm run stdio:library:start
npm run stdio:encyclopedia:start

# Start with debugging
npm run stdio:dictionary:dev
npm run stdio:book-info:dev
npm run stdio:library:dev
npm run stdio:encyclopedia:dev

# Inspect servers
npm run stdio:dictionary:inspect
npm run stdio:book-info:inspect
npm run stdio:library:inspect
npm run stdio:encyclopedia:inspect

HTTP MCP 服务器（远程）

# Start HTTP MCP server
npm run http-mcp:start

# Start with auto-reload
npm run http-mcp:dev

# Build for deployment
npm run http-mcp:build

# Open MCP Inspector
npm run http-mcp:inspect

MCPB 打包（或“MCPB 套件”）

# Build the .mcpb bundle
npm run http-mcp:bundle:pack

这会产生 mcpb/ahaan-thai.mcpb 这可以安装在Claude Desktop中。

发展

有关开发指南和架构详情，请参阅 CLAUDE.md（文件名可译为“克劳德.md”，但通常文件名不直接翻译，保持原样）.

许可证

麻省理工学院（MIT）

作者

煮饭的人