Ansari MCP

安萨里MCP服务器

一种MCP（模型上下文协议）服务器，通过Ansari API提供伊斯兰知识。此服务器允许Claude Desktop、Claude Code、Cursor和其他MCP客户端使用古兰经和圣训的真实来源回答伊斯兰问题。

托管服务器

Ansari MCP服务器可作为托管服务提供，网址为：

https://mcp.ansari.chat/mcp

您可以直接在Claude Code中使用此URL，也可以使用Claude Desktop和Cursor的适配器（请参阅下面的设置说明）。

快速入门-使用托管服务器

使用Ansari MCP最简单的方法是通过我们的托管服务器。无需安装！

克劳德桌面

1. 打开克劳德桌面，点击左下角的个人资料/姓名

1. 从菜单中选择“设置”

1. 导航到“开发人员”选项卡，然后单击“编辑配置”

1. 这将打开 claude_desktop_config.json 默认文本编辑器中的文件

- macOS：位于 ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗：位于 %APPDATA%\Claude\claude_desktop_config.json

1. 添加此配置：

{
  "mcpServers": {
    "ansari": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ansari.chat/mcp"
      ]
    }
  }
}

1. 完全重新启动克劳德桌面（Cmd+Q/Alt+F4并重新打开）

克劳德代码

1. 在Claude Code中打开您的项目
2. 添加到您的 .claude.json 或全局配置：

{
  "mcpServers": {
    "ansari": {
      "type": "http",
      "url": "https://mcp.ansari.chat/mcp"
    }
  }
}

Visual Studio代码（带MCP扩展）

如果您在VS Code中安装了MCP扩展：

1. 打开命令面板（Cmd+Shift+P/Ctrl+Shift+P）
2. 运行“MCP:添加服务器…”
3. 选择“HTTP（HTTP或服务器发送的事件）”
4. 输入URL: https://mcp.ansari.chat/mcp
5. 命名为：“安萨里”

光标

Cursor直接支持HTTP MCP服务器：

{
  "mcpServers": {
    "ansari": {
      "type": "http",
      "url": "https://mcp.ansari.chat/mcp"
    }
  }
}

本地安装（可选）

如果您更喜欢在本地运行服务器：

先决条件

• Node.js（v18或更高版本）
• npm

安装步骤

1. 克隆存储库：

git clone https://github.com/ansari-project/ansari-mcp.git
cd ansari-mcp

1. 安装依赖项：

npm install

1. 构建TypeScript代码：

npm run build

发展

建设项目

重要：对中的TypeScript源文件进行任何更改后 src/，你必须重建：

npm run build

配置

API端点

默认情况下，服务器连接到：

https://staging-api.ansari.chat/api/v2/mcp-complete

你可以用以下命令覆盖它 --api-url （或 -u)标志：

npm start -- --api-url https://custom-api.example.com/api/endpoint

运行服务器

模式1:stdio（适用于克劳德桌面和克劳德代码）

这是与Claude Desktop和Claude Code集成的默认模式：

npm start

模式2:HTTP（用于测试）

要在HTTP模式下运行以使用curl或其他HTTP客户端进行测试，请执行以下操作：

npm start -- --http

服务器将在以下位置可用： http://localhost:8089/mcp

本地服务器配置

如果您在本地运行服务器而不是使用托管版本：

克劳德桌面（本地）

{
  "mcpServers": {
    "ansari": {
      "command": "node",
      "args": ["/absolute/path/to/ansari-mcp/dist/server.js"],
      "env": {}
    }
  }
}

克劳德代码（本地）

{
  "mcpServers": {
    "ansari": {
      "command": "node",
      "args": ["/absolute/path/to/ansari-mcp/dist/server.js"],
      "env": {}
    }
  }
}

光标（本地）

{
  "mcpServers": {
    "ansari": {
      "command": "node",
      "args": ["/absolute/path/to/ansari-mcp/dist/server.js"],
      "env": {}
    }
  }
}

备注：替换 /absolute/path/to/ansari-mcp 使用您的实际安装路径。

用法

配置后，您可以在Claude Desktop或Claude Code中询问伊斯兰问题：

1. 开始新的对话
2. Ansari工具将自动可用
3. 自然地问伊斯兰问题，例如：

- “伊斯兰教的五大支柱是什么？” - “古兰经对慈善有什么看法？” - “解释Tawheed的概念” - 《古兰经》中提到过多少次祈祷

克劳德将使用安萨里工具提供答案，并引用古兰经和圣训中的真实引文。

测试

直接测试API连接

# Create a test file
cat > test-api.mjs << 'EOF'
import { askAnsari } from './dist/ansari-service.js';
askAnsari('What is zakat?').then(console.log);
EOF

# Run the test
node test-api.mjs

使用MCP检查员进行测试

安装并运行MCP检查器：

npx @modelcontextprotocol/inspector dist/server.js

这将打开一个web界面，您可以在其中交互式地测试该工具。

HTTP模式下的测试

1. 启动服务器：

npm start -- --http

1. 服务器将在以下时间运行 http://localhost:8089/mcp

故障排除

Claude Desktop中出现“意外令牌”错误

问题你看 MCP ansari: Unexpected token 'C', "Calling An"... is not valid JSON

解决方案：当console.log语句干扰MCP协议时，就会发生这种情况。代码应该已经删除了这些，但如果你添加任何调试：

• 全部删除 console.log() 声明
• 全部删除 console.error() 声明
• 只有纯JSON-RPC通信应该转到stdout

更改未生效

问题：您修改了代码，但更改无效

解决方案：每次更改后都必须重建：

npm run build

Claude Desktop找不到工具

问题：Ansari工具未出现在Claude Desktop中

解决方案:

1. 验证中的路径 claude_desktop_config.json 绝对正确
2. 确保你跑了 npm run build 成功地
3. 完全重新启动Claude Desktop（退出并重新打开）
4. 检查生成输出是否存在： ls dist/server.js

连接到API失败

问题：“无法从Ansari API获取答案”

解决方案:

1. 检查您的互联网连接
2. 验证API是否可访问： curl https://staging-api.ansari.chat/api/v2/mcp-complete
3. 尝试使用自定义API URL（如果您有）

构建错误

问题：TypeScript编译失败

解决方案:

# Clean and rebuild
rm -rf dist/
npm run build

项目结构

ansari-mcp/
├── src/
│   ├── server.ts           # Main MCP server implementation
│   └── ansari-service.ts   # Ansari API client service
├── dist/                   # Compiled JavaScript (generated by build)
│   ├── server.js          # Compiled server
│   └── ansari-service.js  # Compiled service
├── tmp/                    # Temporary test files (git-ignored)
├── package.json           # Project dependencies and scripts
├── tsconfig.json          # TypeScript configuration
└── README.md             # This file

重要提示

• 更改后始终重建：运行 npm run build 修改任何TypeScript文件后
• stdio模式下无控制台输出：控制台语句将破坏MCP协议
• 使用绝对路径：在Claude桌面/代码配置中，始终使用绝对路径
• 配置更改后重新启动：更改配置后始终重新启动Claude Desktop/Code

api信息

安萨里API提供：

• 古兰经经文，阿拉伯语文本和英语翻译
• 带有等级和来源的真实圣训
• 基于经典伊斯兰文本的学术解释
• 正确引用章节、诗句和圣训数字

支持

对于问题或疑问：

• 检查 问题 页
• API文件：https://staging-api.ansari.chat/redoc
• 联系安萨里项目团队

许可证

\[您的许可证在这里\]