Building a Watsonx.ai Chatbot Server with MCP in Python
@ruslanmv
关于 Building a Watsonx.ai Chatbot Server with MCP in Python
How to create a professional, production‑ready chatbot server powered by IBM Watsonx.ai and exposed via the Model Context Protocol (MCP) Python SDK.
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"watsonx-mcp-server": {
"command": "python3",
"args": [
"-m",
"venv",
".venv"
]
}
}
}工具
未检测到工具
工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。
概览
What is Watsonx Chatbot Server?
Watsonx Chatbot Server is a production‑ready MCP server that exposes IBM Watsonx.ai LLM inference as a standardized “chat” tool. It lets any MCP‑compatible client (e.g., Claude Desktop, custom Python clients) invoke Watsonx.ai responses through the Model Context Protocol.
How to use Watsonx Chatbot Server?
Set up Python 3.9+, a virtual environment, and install python-dotenv, ibm-watsonx-ai, and mcp[cli]. Store your Watsonx.ai API key, URL, and project ID in a .env file. Run mcp dev server.py for live‑reloading development with an Inspector UI at http://localhost:6274/, or run python server.py for direct STDIO mode. Use the sample client script to call the chat tool.
Key features of Watsonx Chatbot Server
- Exposes Watsonx.ai LLM inference as an MCP “chat” tool.
- Provides a dynamic greeting resource via
@mcp.resource. - Includes an optional symptom‑assessment prompt template.
- Supports live reloading and Inspector testing with
mcp dev. - Communicates over STDIO transport with any MCP client.
- Defaults to the
ibm/granite-13b-instruct-v2model.
Use cases of Watsonx Chatbot Server
- Building an internal helpdesk bot that responds to employee queries.
- Creating a public chatbot API that works with any MCP‑aware frontend.
- Rapidly prototyping medical symptom assessment assistants.
- Providing a reusable, modular LLM endpoint for multiple client applications.
FAQ from Watsonx Chatbot Server
What credentials are required to run the server?
You need an IBM Cloud Watsonx.ai API key, service URL, and project ID. Store them in a .env file as WATSONX_APIKEY, WATSONX_URL, and PROJECT_ID.
How do I install the dependencies?
Use pip install -r requirements.txt after creating a virtual environment. The required packages are python-dotenv>=0.21.0, ibm-watsonx-ai==1.3.8, and mcp[cli]>=1.6.0.
What transport does the server use?
The server uses STDIO transport for MCP communication. It runs as a command‑line process and exchanges JSON‑RPC messages over standard input/output.
How can I test the server without writing a client?
Run mcp dev server.py to start the development mode. Open http://localhost:6274/ in a browser to use the MCP Inspector for listing tools, calling the chat tool, and testing resources and prompts.
What model is used by default, and can I change it?
The default model is ibm/granite-13b-instruct-v2. You can override it by setting the MODEL_ID environment variable in your .env file.
AI 与智能体 分类下的更多 MCP 服务器
Intervals.icu MCP Server
mvilanovaModel Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API.
mcp-hfspace MCP Server 🤗
evalstateMCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.
MCP Server - Remote MacOs Use
baryhuangThe only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App
Shell and Coding agent for Claude and other mcp clients
rusiaamanShell and coding agent on mcp clients
MCP Client for Ollama (ollmcp)
joniglHarness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre
评论