Lets agents search verses and get translations and tafsir through the Quran.com API.
接入配置
选择客户端，复制配置，再按项目文档补齐环境变量。
claude mcp add quran --env API_KEY='<API_KEY>' --env VERBOSE_MODE='<VERBOSE_MODE>' -- docker run -i --rm --init -e 'API_KEY={{config.API_KEY}}' -e 'VERBOSE_MODE={{config.VERBOSE_MODE}}' quran-mcp-server~/.codex/config.toml
[mcp_servers.quran]
command = "docker"
args = ["run", "-i", "--rm", "--init", "-e", "API_KEY={{config.API_KEY}}", "-e", "VERBOSE_MODE={{config.VERBOSE_MODE}}", "quran-mcp-server"]
env = { API_KEY = "<API_KEY>", VERBOSE_MODE = "<VERBOSE_MODE>" }
# codex mcp add quran --env API_KEY='<API_KEY>' --env VERBOSE_MODE='<VERBOSE_MODE>' -- docker run -i --rm --init -e 'API_KEY={{config.API_KEY}}' -e 'VERBOSE_MODE={{config.VERBOSE_MODE}}' quran-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"quran": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"quran": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--init",
"-e",
"API_KEY={{config.API_KEY}}",
"-e",
"VERBOSE_MODE={{config.VERBOSE_MODE}}",
"quran-mcp-server"
],
"env": {
"API_KEY": "<API_KEY>",
"VERBOSE_MODE": "<VERBOSE_MODE>"
}
}
}
}需要的环境变量
API_KEYVERBOSE_MODE
把占位值换成你自己的密钥；不要把密钥提交到代码仓库。