Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: Add log to stdio #25

Merged
merged 7 commits into from
Jan 22, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,15 @@

All notable changes to this project will be documented in this file.

<!-- git-cliff-unreleased-start -->
## 0.1.5 - **not yet released**

### 🐛 Bug Fixes

- Add log to stdio ([99a3e9e](https://github.com/apify/actors-mcp-server/commit/99a3e9e8a4fbf52806dd900b9543431d6a1bc083))


<!-- git-cliff-unreleased-end -->
## [0.1.4](https://github.com/apify/actors-mcp-server/releases/tag/v0.1.4) (2025-01-22)

### 🐛 Bug Fixes
Expand Down
25 changes: 16 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -201,13 +201,18 @@ npm run build

#### Claude Desktop

Configure Claude Desktop to recognize the MCP server.
Make sure that you enable developer mode in Claude Desktop to access the configuration settings.
To configure Claude Desktop to work with the MCP server, follow these steps. For a detailed guide, refer to the [Claude Desktop Users Guide](https://modelcontextprotocol.io/quickstart/user).

1. Open your Claude Desktop configuration and edit the following file:
1. Download Claude for desktop
- Available for Windows and macOS.
- For Linux users, you can build a Debian package using this [unofficial build script](https://github.com/aaddrick/claude-desktop-debian).
2. Open the Claude Desktop app and enable **Developer Mode** from the top-left menu bar.
3. Once enabled, open **Settings** (also from the top-left menu bar) and navigate to the **Developer Option**, where you'll find the **Edit Config** button
4. Open configuration file and edit the following file:

- On macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
- On Linux: `~/.config/Claude/claude_desktop_config.json`

```json
{
Expand All @@ -222,14 +227,14 @@ Make sure that you enable developer mode in Claude Desktop to access the configu
}
}
```
Alternatively, you can use the following command to select one or more Apify Actors:
Alternatively, you can use `actors` argument to select one or more Apify Actors:
```json
{
"mcpServers": {
"actors-mcp-server": {
"command": "npx",
"args": [
"-y", "@apify/actors-mcp-serves",
"-y", "@apify/actors-mcp-server",
"--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
],
"env": {
Expand All @@ -239,16 +244,18 @@ Make sure that you enable developer mode in Claude Desktop to access the configu
}
}
```

2. Restart Claude Desktop
5. Restart Claude Desktop

- Fully quit Claude Desktop (ensure it’s not just minimized or closed).
- Restart Claude Desktop.
- Look for the 🔌 icon to confirm that the Exa server is connected.

3. Examples
6. Open the Claude Desktop chat and ask "What Apify Actors I can use?"
![Claude-desktop-with-Actors-MCP-server](https://raw.githubusercontent.com/apify/actors-mcp-server/refs/heads/master/docs/claude-dekstop.png)

7. Examples

You can ask Claude to perform web searches, such as:
You can ask Claude to perform tasks, such as:
```text
Find and analyze recent research papers about LLMs.
Find top 10 best Italian restaurants in San Francisco.
Expand Down
Binary file added docs/claude-desktop.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@apify/actors-mcp-server",
"version": "0.1.4",
"version": "0.1.5",
"type": "module",
"description": "Model Context Protocol Server for Apify Actors",
"engines": {
Expand Down
2 changes: 1 addition & 1 deletion src/examples/clientSse.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
* Connect to the MCP server using SSE transport and call a tool.
* The Actors MCP Server will load default Actors.
*
* !!! This example needs to be fixed as it does not work !!!
* !!! NOT WORKING - This example needs to be fixed as it does not work !!!
*/

import path from 'path';
Expand Down
1 change: 1 addition & 0 deletions src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ async function main() {
: server.addToolsFromDefaultActors());
const transport = new StdioServerTransport();
await server.connect(transport);
console.error('Actors MCP Server running on stdio'); // eslint-disable-line no-console
}

main().catch((error) => {
Expand Down
Loading