mcpium (Realdnchka)

MCP开发工具

提供方 realdnchka

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个针对MCP服务器的现代化、流畅API测试框架,支持链式语法编写确定性测试。

一句话选型结论

按资料字段整理

mcpium (Realdnchka) 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

测试框架Python本地部署MCP服务器自动化测试API测试Python工具

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install mcpium

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
mcpium (Realdnchka)当前 4 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方realdnchka上游标注的维护方 realdnchka
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.5 KB
来自项目仓库与上游目录的原文,未做删改

mcpium(注:此词并非标准英文或中文词汇,可能是特定领域或虚构的术语,直接音译为中文,实际含义需根据上下文确定)

> 针对MCP服务器的Selenium类测试框架

一个现代、流畅的API测试框架,用于 模型上下文协议 服务器。使用简洁、链式语法编写确定性测试。

特点/特性

  • 🔄(循环、重复) 重试与超时 - 内置的对不稳定操作的容错能力
  • 🎯(目标) 丰富的断言 - 15+种断言方法,实现全面验证
  • 📝 类型安全 - 完整的类型提示,以支持集成开发环境(IDE)
  • 📊 表格/数据图表 自动记录 - 自动计时和状态跟踪

快速入门

安装```bash

poetry add mcpium

or

pip install mcpium


### 基本示例```python
import asyncio
from mcpium.core.scenario import Scenario

async def main():
async with Scenario("My first test") as s:
# Simple fluent chain
await s.step("List available tools").list_tools().expect().to_succeed()

# Call a tool and verify result
await s.step("Call tool").call_tool("get_user", id=123).expect().to_equal({"name": "Alice"})

if __name__ == "__main__":
asyncio.run(main())

高级用法

重试与超时```python

async with Scenario("Resilient API Test") as s:
await s.step("Call flaky API") \
.call_tool("external_service", endpoint="/data") \
.with_retry(max_attempts=5, backoff=2.0) \
.with_timeout(30.0) \
.expect().to_succeed()


### 使用提示进行工作```python
async with Scenario("Prompt Test") as s:
# List available prompts
await s.step("List prompts").list_prompts().expect().not_empty()

# Use a prompt with arguments
await s.step("Generate greeting") \
.get_prompt("welcome", {"user": "Alice", "lang": "en"}) \
.expect().to_match_regex(r"Hello.*Alice")

资源测试```python

async with Scenario("Resource Test") as s:

List available resources

await s.step("List resources") \
.list_resources() \
.expect().to_have_length(5)

Read and validate resource

await s.step("Read config") \
.read_resource("file://config.json") \
.expect().to_be_type(dict) \
.has_key("version")


### 复杂断言```python
async with Scenario("Advanced Validation") as s:
await s.step("Process data") \
.call_tool("processor", data=payload) \
.expect() \
.to_succeed() \
.to_be_type(dict) \
.has_key("results") \
.to_have_length(10) \
.to_be_between(5, 20)

API 参考

步骤动作

方法 描述
list_tools() 列出所有可用的MCP工具

| call_tool(name, **kwargs) 调用带有参数的MCP工具
validate(tool_name, **kwargs) · 根据工具模式验证参数
list_prompts() · 列出所有可用提示
get_prompt(name, arguments) · 获取带有模板参数的提示
list_resources() · 列出所有可用资源
read_resource(uri) · 通过URI读取资源

修饰符

方法 描述
.with_retry(max_attempts, backoff) 对失败的操作进行指数退避重试
.with_timeout(seconds) 设置操作超时
.expect() 开始断言链

断言

方法 描述
.to_succeed() 断言操作成功
.to_fail() 断言操作失败
.to_equal(value) 断言精确相等
.to_contain(item) 断言包含项(列表/字典/字符串)
.has_key(key) 断言字典包含键
.has_value(value) 断言字典中有该值
.not_empty() 断言结果不为空
.to_match_regex(pattern) 断言匹配正则表达式模式
.to_have_length(n) 断言长度等于 n
.to_be_greater_than(n) 断言值 > n
.to_be_less_than(n) 断言值 \< n
.to_be_between(min, max) 断言最小值 ≤ 值 ≤ 最大值
.to_be_one_of(values) 列表中的断言值
.to_be_type(type) 断言特定类型
.to_have_error(substring) 断言错误包含子字符串

配置

使用 TOML 配置文件

创建一个 mcpium.toml 在项目根目录中的文件:```toml
[mcpium]
server_uri = "ws://localhost:8765"
default_timeout = 30.0 # Default timeout in seconds for all operations


### 程序化配置```python
from mcpium.core.config import Config
from mcpium.core.driver import MCPDriver
from mcpium.core.scenario import Scenario

# Custom config file
config = Config(config_path=&quot;custom_config.toml&quot;)

# Driver with custom default timeout
driver = MCPDriver(default_timeout=60.0)

# Scenario with custom default timeout (overrides driver and config)
scenario = Scenario(&quot;Custom test&quot;, driver=driver, default_timeout=10.0)

超时优先级(从高到低):

  1. .with_timeout(seconds) 在特定步骤上
  2. Scenario(default_timeout=...)
  3. MCPDriver(default_timeout=...)
  4. mcpium.toml 配置 default_timeout
  5. 无超时(无限期等待)

与 pytest 的集成```python

import pytest
from mcpium.core.scenario import Scenario

@pytest.fixture
async def scenario():
async with Scenario("Test") as s:
yield s

async def test_mcp_server(scenario):
await scenario.step("Test tool").call_tool("test").expect().to_succeed()


## 示例

### 示例1:端到端MCP服务器测试```python
async with Scenario(&quot;E2E Server Test&quot;) as s:
# Verify server capabilities
await s.step(&quot;Check tools&quot;).list_tools().expect().not_empty()
await s.step(&quot;Check prompts&quot;).list_prompts().expect().not_empty()
await s.step(&quot;Check resources&quot;).list_resources().expect().not_empty()

# Test tool execution
result = await s.step(&quot;Execute tool&quot;) \
.call_tool(&quot;calculate&quot;, expression=&quot;2+2&quot;) \
.with_timeout(5.0)

result.expect().to_equal(4)

示例2:验证测试```python

async with Scenario("Schema Validation") as s:

Valid arguments

await s.step("Valid call") \
.validate("create_user", name="Alice", age=30) \
.expect().to_succeed()

Invalid arguments

await s.step("Invalid call") \
.validate("create_user", age="not a number") \
.expect().to_fail()


### 示例3:性能测试```python
async with Scenario(&quot;Performance Test&quot;) as s:
import time

start = time.time()
await s.step(&quot;Fast operation&quot;) \
.call_tool(&quot;quick_task&quot;) \
.with_timeout(1.0) \
.expect().to_succeed()

duration = time.time() - start
assert duration &lt; 1.0, f&quot;Operation too slow: {duration}s&quot;

贡献;做出贡献

欢迎贡献!请随时提交拉取请求。

许可证

MIT 许可证 - 请参阅 许可证 详情请参阅文件。

链接

  • 模型上下文协议
  • MCP Python SDK(MCP Python软件开发工具包)

为MCP社区倾心打造

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
mcpium (Realdnchka) 怎么安装?

在客户端按下面的安装命令接入:pip install mcpium。装完在客户端配置里引用同一个包或端点。

mcpium (Realdnchka) 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

mcpium (Realdnchka) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

mcpium (Realdnchka) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

mcpium (Realdnchka) 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 测试框架、自动化测试、Python、API测试、本地部署。具体工具清单以官方文档为准。

mcpium (Realdnchka) 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

mcpium (Realdnchka) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。